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SHAWN POWERS 


A Pint-Size 


Powerhouse 


with a Tasty- 


For less money that it takes to stop 
at a drive-through, it’s possible to 
buy the top-end RPi model. (Granted, 
| have three teenagers, so the drive- 
through is expensive.) The Raspberry 
Pi is as Open as the manufacturer can 
make it, has huge community support, 
and its software isn’t backed by a huge 
corporation with mysterious motivations 
(cough, Android, cough). It's just a cool 
little ARM device that runs Linux. This 
month, we focus on the Raspberry Pi. 
The drive-through is optional. 

Dave Taylor doesn’t work directly 
with a Raspberry Pi this month, but 
his continuing series on scripting a 
Cribbage game certainly will work on 
an RPi. Even if you're not a Cribbage 
fan, Dave's scripting lessons are 


j t's hard not to love the Raspberry Pi. 
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Sounding Name 


infinitely useful for learning. Reuven 
M. Lerner teaches a thing or two this 
month as well—specifically in regard 
to running background tasks in your 
Web applications. Running things in the 
background can make a monstrous Web 
application perform much more quickly 
from the end user’s perspective. Reuven 
shows how with Sidekiq. 

Kyle Rankin, who first interested me 
in Raspberry Pi devices, talks about 
redundancy this month. What's better 
than a Raspberry Pi? Redundant pies—or 
Pis, rather. If you want to bolster your 
RPi reliability or just want an inexpensive 
platform to learn clustering, Kyle walks 
through the process. I’ve been writing 
about my Raspberry Pi adventures off and 
on for the past six months, so this month, 
| decided to focus on an issue that is near 


and dear to my heart: RSS. If the Google 
Reader shutdown in July has you worried 
about how you'll browse the Web, 
perhaps my column will help. I’m past 
panic mode, and I've been able to wean 
myself off Google Reader altogether. 

I'm probably not the only Linux Journal 
reader who has a full virtualization 
system with iSCSI SAN/NAS storage in 
my basement. Unfortunately, along with 
that nerdy power comes a big electricity 
bill. Brian Trapp describes the other 
end of that spectrum with his article on 
creating the perfect home server—with a 
Raspberry Pi. There are plenty of reasons 
powering your Linux server infrastructure 
with a cell-phone charger is awesome, 
and Brian explains how. If you want to 
add |IPv6 to the mix, Igor Partola follows 
up with an article on creating an IPv6 
router on your network, even if your ISP 
doesn’t support it! 

| realize all my “servers in the 
basement” stuff is almost cliché when 
talking about Linux users. To be fair, | 
didn't say it was my mom's basement. 
Still, Jonathan Brogdon’s article on 
controlling stage lighting with a 
Raspberry Pi is a great way to avoid 
our basement-dwelling stereotype. 
Jonathan literally puts RPi in the 
spotlight with his hardware/software 
combination for controlling external 
lighting. It’s a real-world solution and 
really cool to read about. 


The coming shutdown of Google 
Reader has made all of us think a little 
harder about the dangers of cloud 
computing. At the very least, it’s forced 
us to think about trusting cloud-based 
services we don't directly control. 

Diana Marina Cooper talks about the 
other end of the cloud—specifically as 
it relates to open-source compliance. 
How does the GPL relate to a world of 
“Software as a Service”? If the cloud 
obfuscates the software and the code, 
what does that mean with regards to 
FOSS? Diana takes a serious look at a 
problem not many of us consider. 

Do you have a Raspberry Pi, and are 
you looking for something to do with it? 
Do you already have a rack of clustered- 
RPi devices in your basement, and are 
you looking for tips on optimization? 
Regardless of your immersion level into 
the Pi, this issue should prove useful 
and entertaining. Even if you have no 
interest in the Raspberry Pi, this issue is 
full of the same tech tips and Linux news 
you're used to seeing. This issue was 
incredibly fun to put together, and we 
hope you enjoy it as much as we did.m@ 


Shawn Powers is the Associate Editor for Linux Journal. 

He’s also the Gadget Guy for LinuxJournal.com, and he has an 

interesting collection of vintage Garfield coffee mugs. Don’t let 
his silly hairdo fool you, he’s a pretty ordinary guy and can be 
reached via e-mail at shawn @linuxjournal.com. Or, swing by 

the #linuxjournal IRC channel on Freenode.net. 
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letters 


ie Lenk setpoint) Raspberry Pi Mm @kitestramrt: My Rasp is #3, 
Lie sea We recently housed by @fusabe. Hosts 
cauid ; 
JOURNAL ‘| asked readers http://drift.to/pap, #tt-rss, 
to tweet or #ownCloud and drift.to (Figure 1). 


comment on 
our Web site 


about what 
an STACK nD| they've done 
eS VAGRANT with their 
‘AE “SBGE| Pis. Here 
Cz eng err) are sume 
of the responses: 
mM @gholmer: Using my Pi to run Figure 1. @kitestramrt’s RPI 
a Q-Link Reloaded server: 
http://www.lyonlabs.org/ M @anlarye: | use my pi as an xbmc 
commodore/qlink/index.html media center. 
M @packetgeek: One of my M @Bonbuzaru: #RPi is our 
#RPi boards runs Softsqueeze, computer for a self-built 
as a $35 replacement for a RV/camper: logging GPS & 
$300 Squeezebox. environment data, media centre & 


soon leisure battery monitoring. 
M @retux: Using Raspi with cloud 
storage davfs and encryption 
with encfs. A way to extend 
SD memory lifetime. 


M @strawberrybrick: | use my Raspberry 
Pi as Squeezebox while at work: 
http://my.opera.com/djfake/ isi < 
blog/2012/12/12/squeezeslave- Figure 2. @_hamzux_'s RPI runs 
and-the-raspberry-pi. #owncloud and a #subversion server. 
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mM @_hamzux_: my Raspberry 
Pi running #owncloud and a 
#subversion server #RPi (Figure 2). 


mM jerpi_bilbo: #RPi | am a Raspberry 
Pi Model B w/512MB. | like 
hiking, long walks along the 
beach, and wait...I’m a Linux/ARM 
target board. 


M @josephbottinger: Raspberry Pi 
running a midi foot controller 
AKA Alcyone Beta (Figure 3). 


Figure 3. @josephbottinger’s RPI runs a 
midi foot controller AKA Alcyone Beta 


M @shawnpOwers: My Raspberry 
Pi dangles naked behind my 
television, running RaspBMC! 


m Submitted by bolt on LJ.com: My 
Raspberry Pi sits in the middle of the 
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living room, on a shelf, outputting 
sound to my stereo while looking 
like an out-of-place ancient SCSI 
CD-ROM. Controlled remotely 

with SSH from an Android phone 
(http://blog.dhampir.no/content/ 
cd-rom-raspberry-pi-case). 


Thanks for all the feedback folks! It’s 
great to see how everyone uses their 
Raspberry Pis.—Ed. 


SIGALRM Timers and Stdin Analysis 
Regarding Dave Taylor's article 
“SIGALRM Timers and Stdin Analysis” 
in the November 2012 issue: here's 

a method that’s a little tidier. | 
commented out the “tracing” prints. 
With more thought, it could be made 
to handle concurrent timed tasks: 


#! /bin/bash 


function allow_time 


{ 


#echo timer allowing $1 seconds for execution 
sleep $1 
kill -ALRM $$ 

) & 

alarmPID=$! 


taskTimedOut=0 


WWW.LINUXJOURNAL.COM / MAY 2013 / 13 


, LETTERS | 


function timeout_handler 
{ 
#echo allowable time for execution exceeded. 


taskTimedOut=1 


function timeTask 
{ 
trap timeout_handler SIGALRM 
allow_time $2 
#echo "alarmPID=$alarmPID" 
$1 
if [ $taskTimedOut -eq 0 ]; then 
kill -9 $alarmPID 
wait >/dev/null 2>&1 
true 
return 
else 
false 


return 


echo "Finishes soon enough" 


timeTask "sleep 2" 4 || (echo "task 1 took too long"; exit 1;) 


echo "Takes too long" 


timeTask "sleep 5" 4 || (echo "task 2 took too long"; exit 1;) 


—Neal Murphy 
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Dave Taylor replies: Nice solution, Neal! 


Linux in Education 

To Shawn Powers: | happened upon your 
blog following a link in the last issue of 
Linux Journal (to which | subscribe)—the 
Gc script. | will give it a try, and let you 
know how it worked for me. 


As a fellow Director of Technology 

of a school district, | imagine that 

you must be facing similar challenges 
when it comes to implementing and 
adopting Linux in your environment. | 
am a Microsoft-certified professional, 
a Mac lover and a Linux enthusiast 
(although | still consider myself a 
newbie), and as such, | want to give 
our students and faculty more choices 
when it comes to computer platforms. 
Last year, | converted some older PCs 
from Windows XP to Linux Mint, but 
the experience wasn’t a totally positive 
one. Because of that, | am somewhat 
reluctant to try again or to expand 
Linux to more of our schools. The main 
issue was an Inability to make the Linux 
experience an enjoyable one to the 
users and to make Linux “play nice” 

in an Active Directory environment 
(especially when it came to accessing 
and saving files to network shares). | 
wrote asking for help and advice from 


the Linux Journal folks, but no one 
even acknowledged my messages. 


If you are currently using Linux in your 
school district, I'd be happy to know 
which distribution works best for 

your students, and I’d appreciate any 
recommendations, tips or advice you 
might have for me. Also, perhaps you can 
convince your colleagues at Linux Journal 
to do a story about the use of Linux in 
K-12 education. I’m sure that it would 
inspire other IT professionals who might 
be struggling with the same issues as | am. 
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Thank you and looking forward to 
your Insight. 
—Lucian Micu 


Indeed, it’s difficult to bolster the 

usage of Linux in an environment bent 
on proprietary solutions. Through the 
years, I’ve used several distributions in 
our school, but for the past few years, 
I’ve had the most luck with Ubuntu or a 
variant. | didn’t have an Active Directory 
environment, but | found that hosting 
files on a Linux server worked best for 
me. | could share via NFS with my Linux 
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a. Your Service 
thin clients, and SMB with Windows and OS x. | 
even used netatalk to share with OS X sometimes. 
Because it was from a central Linux file server, | 
could share the same files over a variety of protocols. 
You may not have that option, which means lots 
more work and testing, unfortunately. Good luck, 
and keep fighting the good fight!—Shawn 
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diff -u 


WHAT?’S NEW IN KERNEL DEVELOPMENT 


Remember the SCO lawsuit, claiming 
Linux used code from UNIX System 
V? Disproving that claim required a 
tremendous amount of work, partly 
because Linux had no revision control 
system to help track down the 
original authors of any given patch. 

In response to that whole mess, 
Linus Torvalds implemented the 
Developer's Certificate of Origin 
(DCO) in 2004, which required people 
submitting a kernel patch to include 
a “Signed-off-by” header, identifying 
themselves and certifying that the 
code was legal to go into the kernel. 

Luis R. Rodriguez recently said 
the DCO was so great, that a lot of 
other projects had started using it, 
but that in some cases, they weren't 
using It in a way that actually would 
help them track the origins of 
each patch. He wanted to extract 
the text of the DCO into its own 
git repository, so that other free 
software projects could access the 
explanatory text more easily and 
use it better. 

This initially met with some 
resistance from people like Alan 
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Cox and Jiry Slaby who felt that 
any project wishing to use the DCO 
could extract it from the kernel 
sources without much of a problem. 
They saw no reason for a standalone 
git repository. 

W. Trevor King disagreed. He felt 
a standalone git tree for the DCO 
would be a fine idea. But (ironically), 
he had some copyright questions 
about the DCO itself. He said that 
in the initial patch to add the text 
of the DCO to the kernel sources, 
Linus hadn't used a “Signed-off- 
by” header, so he couldn't be sure 
the DCO’'s explanatory text even 
was legal to release under the GPL 
version 2. That might seem like 
nitpicking, except that Trevor also 
pointed out that the Open Source 
Development Labs (OSDL) had 
put out a press release announcing 
the existence of the DCO and had 
specifically licensed the DCO under 
the Creative Commons Attribution- 
ShareAlike 2.5 License. 

This could have turned out to be 
a thorny issue—except it didn’t. No 
one spoke up to clarify the licensing 


question on the linux-kernel mailing 
list. It went completely unanswered. 

Trevor, however, didn‘t wait. He 
created a new git repository at 
https://github.com/wking/ 
signed-off-by, exactly along the 
lines of what Luis originally had 
requested. It even preserved the 
commit history of the DCO, through 
to its current version of 1.1. 

To address the licensing question 
himself, he said that the project 
was derived from the GPLv2 Linux 
kernel, so it also was released 
under that same license. But, he 
also said, “Because many projects 
that are not GPLv2 may still want 
to use the DCO/s-o-b approach, I’ve 
included an example CONTRIBUTING 
file (and CONTRIBUTING.md for 
GitHub) that are licensed under the 
very permissive Creative Commons 
CCO 1.0 Universal. Merge the 
‘contributing’ or ‘contributing- 
github’ branch into your project and 
edit as you see fit.” 

Somehow | don’t think anyone will 
start complaining about any leftover 
licensing issues that may remain 
concerning the DCO. Luis certainly 
won't. He immediately replied to 
Trevor, saying he’d already started 
using Trevor’s repository in his own 


(| UPFRONT | 


free software projects. 

A fight broke out recently on the 
linux-kernel mailing list between 
the kvmtool developers (primarily 
Ingo Molnar and Pekka Enberg) 
and Linus Torvalds. The issue was 
whether kvmtool should go into the 
official kernel tree. 

kvmtool is used by the KVM 
(Kernel Virtual Machine) subsystem 
to boot up virtual computers under a 
running Linux system. It’s awesome. 
Everyone should use it, whether they 
have a need for it or not. Create 
your own cluster of 20 systems 
without spending a dime. 

There was a lot of heated back- 
and-forth discussion over what 
to do. Essentially, Ingo and Pekka 
argued that kvmtool should be 
included in the official kernel 
sources, because kvmtool was tightly 
integrated with kernel development. 
They relied on the same pool of 
developers and used the same 
mailing lists. Ports of the KVM 
subsystem to other architectures 
would have a functioning kvmtool 
immediately—in some cases before 
the KVM port even had been 
completed. Ingo and Pekka cited 
many examples of instances where 
the existence of kvmtool in the 
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kernel tree (really in the linux-next tree, 
waiting to go to Linus) had resulted in 
better, stronger, faster development overall. 
They argued that this constituted a real 
benefit that would be lost if kvmtool had to 
exist outside the kernel. Without that tight 
integration, development would be slower, 
and the kvmtool developers would have to 
implement all the infrastructure required by 
a standalone project. 

Linus, however, was completely unmoved 
by any of these arguments. In fact, the 
whole idea of speeding up development 
and making things easier for the developers 
didn't register to him as even remotely 
relevant to whether a piece of code should 
go into the kernel. 

Instead (which he said over and over 
again), he needed to have a solid technical 
reason why the code “belonged” in the 
kernel rather than staying outside. It had 
to make sense, not from his personal 
perspective or from any other developer's 
perspective, but from the kernel’s 
perspective itself. Did kvmtool really belong 
in the kernel? And that question, he said, 
Ingo and Pekka had not even addressed. 

Ultimately, he simply refused to merge the 
code, and the kvmtool developers probably 
will extract it from the kernel and create a 
standalone git repository and the rest of the 
necessary infrastructure. Or, they'll articulate 
better technical (and less developer-focused) 
reasons why kvmtool should be more tightly 
integrated.—ZACK BROWN 
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I'd learned enough about 
circuitry in high school 
electronics to know how 
to drive a TV and get 

it to draw—shapes of 
characters and things. 
—Steve Wozniak 


I think it’s very 
comforting for people 

to put me in a box. “Oh, 
she’s a fluffy girlie girl 
who likes clothes and 
cupcakes. Oh, but wait, 
she is spending her 
weekends doing hardware 
electronics.” 

—Marissa Mayer 


Other kids went out and 
beat each other up or 
played baseball, and | 
built electronics. 
—Robert Moog 


When I was a teenager 
in the late 1930s and 
early 1940s, electronics 
wasn't a word. You 
were interested in radio 
if you were interested 
in electronics. 

—Ken Olsen 


I met Woz when I was 13, 
at a friend's garage. He 
was about 18. He was, 
like, the first person | 
met who knew more 
electronics than | did at 
that point. 

—Steve Jobs 


Non-Linux FOSS: 
Seashore 


No modifiers active 


PAREN CEES CARAFE 


Spacing: 20% Circle (015) 


Figure 1. Based on the interface alone, it’s obvious Seashore 
is a native OS X application. 
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open-source 
photo-editing 
application for 
OS X named 
Seashore. 
Seashore is 
an application 
written in the 
native OS X 
Cocoa language, 
so it clearly 
looks like 
a native 
application when 
running (Figure 
1). Although 
OS X users no 
longer have to 
install X11 in 
order to take 
advantage of 


As Linux users, we tend to take GIMP, Seashore is a powerful image 
programs like GIMP for granted. editor in its own right, and because 
Thankfully, as of version 2.8.2, it’s open source, it’s well worth 
GIMP is available as a native the effort to try it out! You can 
application for OS X! Because download Seashore at 

everyone reading this most likely http://seashore.sourceforge.net. 
is familiar with how awesome The native version of GIMP is 

GIMP is for photo editing, it’s available at http://www.gimp.org/ 
worth mentioning there is another downloads.—SHAWN POWERS 
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Raspberry Pi Poll 


We asked LinuxJournal.com readers about their Raspberry Pis, and the results 
are below. We see that 11% indicated that they have multiple models, and 6% 
own more than 3 Pis, and at $35 a piece, we can hardly blame you. Also fun to 
note is that 77% of respondents bought their Pis with no specific purpose in 
mind, just to experiment with, which is yet another fabulous side effect of the 
low price and wee form factor. Only 35% of our readers indicated that the Pi 

is not fast enough to use as a desktop machine, while the rest found it at least 
sufficient enough for basic tasks. Command-liners and GUI users are split down 
the middle with 50% each, which is not surprising considering the multitude of 
applications for a Pi, each of which lends itself to a different way of interacting. 
And finally, Raspian is the favorite operating system by far, but there are many 
to experiment with. So, please continue to enjoy your Pi, and we'll continue 


writing about new and fun ways to help you with that. 


1) Do you own a Raspberry Pi? 
M Yes: 83% 
mM No: 17% 


2) If you own a Raspberry Pi, which 

model do you own? 

m Model A: 5% 

m Model B: 35% 

m Updated Model B with 512MB of 
RAM: 49% 

m Multiple models: 11% 


3) What do you keep your Raspberry Pi 

units in? 

m Computer case for RPi: 53% 

™ Custom-built case (Legos, Pop-Tart 
box and so on): 16% 

@ No case, it hangs in the wind: 31% 
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4) If you own a Raspberry Pi, did you 
pay extra for the MPEG2 license? 

m Yes: 14% 

m No: 86% 


5) What potential model C feature is 
most important to you? 

m USB boot: 37% 

m PXE/Etherboot booting: 17% 

m@ Power Over Ethernet (POE): 32% 
m Other: 14% 


6) Do you overclock your RPi? 
M Yes: 31% 
Mm No: 69% 


7) What operating system is on your 
Raspberry Pi? 
Rasplan: 63% 
RaspBMC: 9% 
OpenELEC: 6% 
Fedora Remix: 3% 
PiBang Linux: <1% 
Arch Linux: 9% 
SliTaz: <1% 
Android: 2% 
Other: 7% 


8) Did you buy a Raspberry Pi... 
m For a specific purpose: 23% 
M To experiment with: 77% 


9) Did you already own the required 

peripherals (SD card, Micro USB power 

adapter, HDMI cable)? 

m Yes, | have several of each: 47% 

m | had some and had to buy some: 45% 

m No, and it more than doubled the 
cost: 8% 


10) Is the Raspberry Pi fast enough for 

you to use as a desktop machine? 

m Yes: 8% 

M No: 35% 

m™ For basic things, but not as my 
main computer: 57% 
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11) Do you use a GUI on your 

Raspberry Pi or CLI only? 

@ CLI only (server, etc.): 50% 

m GUI (desktop or video playback): 
50% 


12) How many Raspberry Pis do you own? 
m@ 1:6/7% 

mM 2-3: 27% 

m More than 3: 6% 


Ultra Small Panel PG 


* ARMY 400Mhz Fanless Processor 
* Up to 1 GB Flash & 256 MB RAM 

° 4.3" WQVGA 480 x 272 TFT LCD 

* Analog Resistive Touchscreen 

* 10/100 Base-T Ethernet 
°3RS232 & 1 RS232/422/485 Port 
* 1 USB 2.0 (High Speed) Host port 
° 1 USB 2.0 (High Speed) OTG port 
*2\MicroSD) Flash\Card|Sockets 

* SPI &12C, 4 ADC, Audio Beeper, 

* Battery Backed Real Time Clock 
* Operating Voltage: 5V DC or 8 to 35V DC # 
* Optional Power Over Ethernet (POE) é 
* Optional Audio with Line-in/out 

* Pricing starts at $375 for Qty 1 


2.6 KERNEL. 


The PPC-E4+ is an ultra compact Panel PC that comes ready to 
run with the Operating System fully configured on the onboard 
flash. The dimensions of the PPC-E4+ are 4.8” by 3.0”, about the 
same as that of popular touch cell phones. The PPC-E4+ is small 
enough to fit in a 2U rack enclosure. Apply power and watch either 
the Linux X Windows or the Windows CE User Interface appear 
on a vivid 4.3” color LCD. Interact with the PPC-E4+ using the 
responsive integrated touch-screen. Everything works out of the 
box, allowing you to concentrate on your application rather than 
building and configuring device drivers. Just Write-It and Run-lt. 


www.emacinc.com/panel_pc/ppc_e4+.htm 


SINGLE BOARD 
SOLUTIONS 


Phone: ( 618) 529-4525 e Fax: (618) 457-0110 e Web: www.emacinc.com 
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Designing Electronics 


with Linux 


In many scientific disciplines, the 
research you may be doing is 
completely new. It may be so new that 
there isn’t even any instrumentation 
available to make your experimental 
measurements. In those cases, you 
have no choice but to design and build 
your own measuring devices. Although 
you could build them using trial and 
error, having a way to model them 
first to see how they will behave is a 
much better choice—in steps oregano 


Untitled.oregano 


(https://github.com/marc-lorber/ 
oregano). With oregano, you can 
design your circuitry ahead of time and 
run simulations on it to iron out any 
problems you may encounter. 

The first step, as always, is installing 
the software. Most distributions should 
have a package for oregano available. If 
you want to follow the source version, 
it is available at GitHub. Oregano also 
needs another software package to 
handle the actual simulation. The two 
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Figure 1. On startup, you get a blank canvas and a parts list. 
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packages it currently can work with are 
Gnucap and ngspice. Either of these two 
packages needs to be installed in order 
to do the calculations for the simulation. 
While this is handled automagically by 
your distribution’s package manager, 
you will need to install this dependency 
yourself if you are building from source. 
Once it’s installed, you will get a 
blank new project when you first start 
up oregano (Figure 1). On the right- 
hand side, you should see a list of 
elements you can use to build your 
circuits. It starts up with the default 
library selected. This library provides all 
the standard electronic components you 
likely will want to use. But, this isn’t the 
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only library included. You can select from 
other libraries, such as TTL, Linear, CPU 
or Power Devices, among others. 

Each of these libraries contains a 
list of associated elements you can 
use in your circuits. Selecting one of 
the elements shows a preview of the 
schematic drawing of that element in 
the bottom window. You then can drag 
and drop the element onto your canvas 
and start building your circuit. Once you 
have an element on the canvas, you 
can double-click the element to edit its 
properties (Figure 2). You need to click 
on the “Draw wires” icon at the top 
of the window in order to connect the 
elements together into a proper circuit. 


General Model 
Designation 
Model 


Template 


Part Properties 


Qi 


NPN 


Q_@refdes %c %b %e @mod: | 


Library: Default 


Search: 
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AC Power 110V 
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BJT NPN 
| BJT NPN-DAR 
| BJT NPN-PHOTO 
| BJT PNP 
BJT PNP-DAR A| 


Preview 


+ 


Bipolar junction 
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Figure 2. The property window depends on which properties are available for that element. 
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All circuits have some necessary 
components to make an actually 
functioning circuit. The first of these is 
the ground. This element is labeled GND 
in the default library. Along with ground, 
you need some sort of power source. 

In most cases, you will want some 

form of DC current. This is provided by 
the element labeled with VDC in the 
default library. With those two important 
elements in your circuit, you can go 
ahead and wire up the rest of the circuit. 

Once you have a circuit made up, 
you will want to run a simulation to 
see how it behaves. Because of the 
nature of electrical circuits, you need 
to put sensors into the circuit to see 


Oregano 


its behavior. You can click on the 
“Add voltage clamp” icon at the top 
of the window to select the sensor 
object. Then, you can click on the 
areas of your circuit where you want to 
measure during the simulation. At each 
point you click, you will see a new 
icon on your circuit marking a sensor 
location. Double-clicking on the clamp 
will pop up a window where you can 
set the parameters of what is being 
measured (Figure 3). You need at least 
one clamp in your circuit before you 
can run a simulation; otherwise, you 
won't have any measurements to study 
in your simulation. 

Once you have all of your clamp points 
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Figure 3. Here you can select the properties for the clamp. 
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selected, you can run the simulation 
and see what happens by clicking on 
the “Run a simulation” icon at the top 
of the window (Figure 4). When you do 
SO, Oregano opens a new window where 
you can see a plot of the data registered 
by the clamp (usually voltage or current). 
When you do analysis, you have the 
choice of two different circuit analysis 
programs: Gnucap and spice. On Ubuntu, 
the default analysis program that Is 
installed as a dependency is Gnucap. 
This means you need to install spice 
explicitly if you want to use it instead. 
To select the analysis engine, click on 
Edit—Preferences. In this dialog, you 
also can set whether the log window 


Oregano - Plot 
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will open automatically when needed, 
and you can set the data paths for the 
models and libraries that will be available 
for your circuits. In most cases, you will 
want to leave those as they are. 

To help you get started, oregano 
comes with several examples. Again, 
on Ubuntu (since that is my current 
desktop), these examples are located 
in /usr/share/doc/oregano/examples. 
You might want to load one of these 
examples first. 

Once you have a completed circuit 
and want to run a simulation, you will 
need to set parameters to control this 
simulation. Click on the menu item 
Edit—Simulation Settings to bring up 
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Figure 4. Plotting the results of a circuit clamp. 
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the dialog window. The first tab lets 
you see analysis parameters, such as 
transient options, fourier options, DC 
sweep options and AC options. Clicking 
on any of the check boxes will open up 
a subset of further options for each of 
those sections. The second tab lets you 
set a series of analysis options. You also 
can set parameters that may affect your 


circuit, such as the ambient temperature. 


Once you have all of the options 
and parameters set, you can start the 
simulation by selecting the menu item 
Tools—Simulate or by pressing F11. 
Don't forget to attach some test clamps 


first; otherwise, you will get an error. 
Your simulation will run and pop up a 
new plot window where you can look at 
the values generated within your circuit. 
You can select whether to look at the 
transient analysis or AC analysis. 

On the left, you will see a list of 
available plotting options. On the right- 
hand side, you will find the actual plot of 
your data. Only the items that you select 
from list will be plotted, so that means 
when this window first opens, nothing 
actually will be plotted. 

You also can plot functions of the 
available values. For example, you could 


DDs 


18 HDDs per 


Ae 


plot the difference in voltage between 
two separate test clamps. These 
functions will be available in the list on 
the left side, so you can select them and 
have them plotted on the graph. 
Additionally, you can include even 
more complicated elements like full CPUs 
to your circuit. The problem with these 
is that the way they respond to electrical 
signals can be very complicated. These 
elements need a separate model file 
that describes this response to signals. 
Unfortunately, the licensing for model 
files means that many cannot be 
included with oregano. You can search 
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the Internet and download the model 
files for the elements that interest you, 
or you can create your own model file. In 
either case, you can place the model files 
into the directory set in the preferences. 
When you actually want to build your 
circuit, you can export the associated 
diagram by clicking on the menu item 
File—Export. You then can export the 
circuit diagram as either an SVG file, a 
PDF, a PostScript file or a PNG. Now, you 
can go ahead and build your new test 
equipment, secure in the knowledge that 
you did some initial testing and should get 
the behavior you need._JOEY BERNARD 
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Add More Fruit to Your 
Raspberry Pi! 


The Raspberry Pi 
can be a building 
block to nerdery! 


ou et 


(Photo from http://www.adafruit.com.) 


Since this is our Raspberry Pi issue, | did 
some research on “what folks do with 
their Raspberry Pi”. | sent out queries 
via Twitter, Facebook, the Linux Journal 
Web site and even the #linuxjournal IRC 
room. When it comes to doing extra- 
geeky projects with the RPi, every person 
| spoke with mentioned buying parts 
from Adafruit. 

Anybody familiar with Raspberry 
Pi development most likely has done 
business with Adafruit. | had the 
pleasure of speaking with Limor Fried, 
owner of Adafruit Industries regarding 
its most popular products. Although 
| was expecting the most common 
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Raspberry Pi-related sales to be cases or 
SD cards, as it happens, the list of most- 
popular products was much geekier! 
While the low-profile microSD card 
adapter is popular, Limor told me the 
breakout boards and breadboard PCB 
kits are the most-popular items. This 
news both surprised and fascinated me. 
Although I’ve certainly done some cool 
things with RPi, the notion that folks 
have been doing elaborate and complex 
projects based on the Raspberry Pi is 
awesome! (A special thanks to Limor at 
Adafruit for talking to me about what 
folks are doing with their Raspberry Pi 
devices.)—SHAWN POWERS 


The Android Developer Conference 


BOSTON « May 28-31, 2013 


The Westin Boston Waterfront 


Get the best real-world Android 
developer training anywhere! 


¢ Choose from more than 75 classes 
and tutorials / 


¢ Network with speakers and other P=N 
Android developers oS 


¢ Check out more than 
40 exhibiting companies 


“AnDevCon is one of the best 
networking and information hubs 
available to Android developers.” 

—wNate Vogt, Android Developer, 

Willow Tree Apps 


+ : Hi AnDevCon™ is a trademark of BZ Media LLC. Android™ is a trademark of Google Inc. Google's Android Robot 
A BZ Media Event Follow us: twitter.com/AnDevCon is used under terms of the Creative Commons 3.0 Attribution License. 


Android Candy: Pan 
Outer Space, 
in Your Pocket 


When the Space Shuttle program 
shut down, | have to admit, it 
deflated my excitement about space 
exploration just a bit. Although it’s 
not fair to pin the future of manned 
missions to space on a fleet of aging 
crafts built in the 1980s, the Space 
Shuttle represented the latest step Bp Ss Ramisererelpee rans amen a 
in a process that would get us to 
other planets. Because there wasn’t ee 
anything immediately replacing the 
Shuttle, it felt like we were giving 
up on space. (Some might argue 
we gave up on space after landing 
on the moon, but that’s an entirely 
different discussion.) 

Then the Mars Curiosity rover Comets 
arrived at Mars, and | remembered 
how much | love science! My daughter 
stayed up late with me, and we 
passed a jar of peanuts back and forth 
while we chewed our nails watching 


INASA Featured: Year of the Solar System 


Scale of the Solar System 


Formation of the Solar System 


> ) Our Favorite Things 


Leftovers from Planet Building 


NASA TV. The seven minutes of hell thing she did was look on her phone 
ended, and after a painfully long for NASA information, and I’m glad 
wait, we heard from Curiosity! My she did. 

excitement was palpable, and that If you haven't looked at the NASA 
moment sparked a new generation of — Android app in a while, you owe it to 
space geek in my daughter. The first yourself to check it out. The last time 
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| tried a NASA app, it was a simple 
streaming app that did a poor job 

of streaming the NASA TV video. It 
crashed. It was ugly. It did not inspire 
awe or excitement. The current NASA 
app is amazing! Not only does It 
have high-definition streaming video 
(which doesn’t seem to crash), it 

also has information on current and 
upcoming missions, a launch calendar, 
categorized information on moons 
and planets, and tons of other space- 
nerd fodder. It even will change the 
background photo on your Android 


device to the Astronomy Pic of the Day. 


| think my favorite feature of the 
NASA app is its ability to grab your 
GPS location and tell you exactly 
where and when to spot things like the 
International Space Station! If you’re 
a space nerd like | am, | urge you to 
grab your jar of peanuts and let the 
NASA app touchdown on your Android 
device (https://play.google.com/ 
store/apps/details?id=gov.nasa). 
It’s so much better than the last time 
| tried it, several years ago, that 
the NASA app for Android is this 
month's Editors’ Choice. 
—SHAWN POWERS 
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Tablet: Raven 


Raven X230/X230 Tablet 

© ThinkPad X230/X230 tablet by Lenovo 
© 12.1" HD LED w/ X@1366x768 

© 2.6-2.9 GHz Core i7 

e Up to 16 GB RAM 

© 750 GB hard drive / 180 GB SSD 
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° Starts at $2050 
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Tarantula CF-31 

e Panasonic Toughbook CF-31 
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drops, dust, moisture & more 

e 13.1" XGA TouchScreen 

e 2.4-2.53 GHz Core i5 
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© 320-750 GB hard drive / 512 GB SSD 
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Want to speed up your Web application? Putting 
some tasks into the background is likely to help. 


From my perspective, one of the 
best parts of being a Web developer 
is the instant gratification. You write 
some code, and within minutes, it 
can be used by people around the 
world, all accessing your server via 

a Web browser. The rapidity with 
which you can go from an idea to 
development to deployment to actual 
users benefiting from (and reacting 
to) your work is, in my experience, 
highly motivating. 

Users also enjoy the speed with 
which new developments are 
deployed. In the world of Web 
applications, users no longer need 
to consider, download or install the 
“latest version” of a program; when 
they load a page into their browser, 
they automatically get the latest 
version. Indeed, users have come 
to expect that new features will be 
rolled out on a regular basis. A Web 
application that fails to change and 
improve over time quickly will lose 
ground in users’ eyes. 

Another factor that users consider 
is the speed with which a Web 
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application responds to their clicks. 
We are increasingly spoiled by the 
likes of Amazon and Google, which 
not only have many thousands of 
servers at their disposal, but which 
also tune their applications and 
servers for the maximum possible 
response time. We measure the 
speed of our Web applications in 
milliseconds, not in seconds, and 

in just the past few years, we have 
reached the point when taking even 
One second to respond to a user Is 
increasingly unacceptable. 

The drive to provide ever-greater 
speed to users has led to a number 
of techniques that reduce the delays 
they encounter. One of the simplest is 
that of a delayed job. Instead of trying 
to do everything within the span of 
a single user request, put some of it 
aside until later. 

For example, let's say you are 
working on a Web application that 
implements an address book and 
calendar. If a user asks to see all 
of his or her appointments for the 
coming week, you almost certainly 
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could display them right away. But if 
a user asks to see all appointments 
during the coming year, It might take 
some time to retrieve that from the 
database, format it into HTML and 
then send it to the user’s browser. 
One solution is to break the 
problem into two or more parts. 
Rather than having the Web 
application render the entire 
response together, including the list 
of appointments during the coming 
year, you can return an HTML page 
without any appointment. However, 
that page can include a snippet of 
JavaScript that, after the page is 
loaded, sends a request to the server 
asking for the list. In this way, you 
can render the outline of the page, 
filling it with data as it comes in. 
Sometimes, you can’t divide jobs in 
this way. For example, let’s say that 
when you add a new appointment 
to your calendar, you would like 
the system to send e-mail to each 
of the participants, indicating that 
they should add the meeting to their 
calendars. Sending e-mail doesn’t 
take a long time, but it does require 
some effort on the part of the server. 
If you have to send e-mail to a large 
number of users, the wait might be 
intolerably long—or just annoyingly 
long, depending on your users and 
the task at hand. 


Thus, for several years, developers 
have taken advantage of various 
“delayed jobs” mechanisms, making 
it possible to say, “Yes, | want to 
execute this functionality, but later 
on, in a separate thread or process 
from the handling of an HTTP 
request.” Delaying the job like this 
may well mean that it'll take longer 
for the work to be completed. But, 
no one will mind if the e-mail takes 
an additional 30 seconds to be sent. 
Users certainly will mind, by contrast, 
if it takes an additional 30 seconds to 
send an HTTP response to the users’ 
browser. And in the world of the Web, 
users probably will not complain, but 
rather move on to another site. 

This month, | explore the use of 
delayed jobs, taking a particular 
look at Sidekig, a Ruby gem (and 
accompanying server) written by Mike 
Perham that provides this functionality 
using a different approach from 
some of its predecessors. If you’re 
like me, you'll find that using 
background jobs is so natural and 
easy, it quickly becomes part of your 
day-to-day toolbox for creating Web 
applications—whether you're sending 
many e-mail messages, converting 
files from one format to another or 
producing large reports that may take 
time to process, background jobs are 
a great addition to your arsenal. 
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Background Queues 

Before looking at Sidekig in particular, 
let's consider what is necessary for 
background jobs to work, at least 

in an object-oriented language like 
Ruby. The basic idea is that you create 
a class with a single method, called 
“perform”, that does what you want 
to execute. For example, you could do 
something like this: 


class MailSender 
def perform(user) 
send_mail_to_user (user) 
end 
end 


Assuming that the send_mail_to_user 
method has been defined in your 
system, you can send e-mail with 
something like: 


MailSender.new.perform(user) 


But here’s the thing: you won't ever 
actually execute that code. Indeed, 
you won't ever create an instance of 
MailSender directly. Rather, you'll invoke 
a class method, something like this: 


MailSender.perform_async (user) 
Notice the difference. Here, the 
class method takes the parameter 


that you eventually want to be passed 
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to the “perform” method. But the 
“perform_async” class method instead 
stores the request on a queue. At 
some point in the future, a separate 
process (or thread) will review method 
calls that have been stored in the 
queue, executing them one by one, 
separately and without any connection 
to the HTTP requests. 

Now, the first place you might 
consider queuing method classes 
that you'll want to execute would be 
in the database. Most modern Web 
applications use a database of some 
sort, and that would be a natural first 
thought. And indeed, in the Ruby world, 
there have been such gems as “delayed 
job” and “background job” that do 
indeed use the database as a queue. 

The big problem with this 
technique, however, is that the queue 
doesn’t need all of the functionality 
that a database can provide. You can 
get away with something smaller and 
lighter, without all the transactional 
and data-safety features. A second 
reason not to use the database Is to 
split the load. If your Web application 
is working hard, you'll probably want 
to let the database be owned and 
used by the Web application, without 
distracting it with your queue. 

So, it has become popular to use 
non-relational databases, aka NoSQL 
solutions, as queues for background 
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jobs. One particularly popular choice 
is Redis, the super-fast, packed- 
with-functionality NoSQL store that 
works something like a souped-up 
memcached. The first job queue to 
use Redis in the Ruby world was 
Resque, which continues to be 
popular and effective. 

But as applications have grown 
in size and scope, so too have the 
requirements for performance. Resque 
is certainly good enough for most 
purposes, but Sidekig attempts to 
go one better. It also uses Redis as 
a back-end store, and it even uses 
the same storage format as Resque, 
so that you either can share a Redis 
instance between Resque and Sidekig 
or transition from one to the other 
easily. But, the big difference is that 
Sidekiq uses threads, whereas Resque 
uses processes. 


Threads? In Ruby? 

Threading in Ruby is something of a 
sore subject. On the one hand, threads 
in Ruby are super-easy to work with. 

If you want to execute something in a 
thread, you just create a new Thread 
object, handing it a block containing 
the code you want to execute: 


Thread.new do 
STDERR.puts "Hello!" # runs in a new thread 


end 


The problem is that people who 
come from languages like Java often 
are surprised to hear that although 
Ruby threads are full-fledged system 
threads, they also have a global 
interpreter lock (GIL), which prevents 
more than one thread from executing 
at a time. This means that if you spawn 
20 threads, you will indeed have 20 
threads, but the GIL acts as a big 
mutex, ensuing that no more than one 
thread is executing simultaneously. 
Thread execution typically switches 
for I/O, and given that nearly every 
program uses I/O on a regular basis, 
this almost ensures that each thread 
will be given a chance to execute. 

| should note that Ruby isn’t the 
only language with these Issues. 
Python also has a GIL, and Guido 
van Rossum, Python's creator, has 
indicated that although he certainly 
wants Python to support threading, 
he personally prefers the ease and 
security of processes. Because 
processes don’t share state, they 
are less prone to difficult-to-debug 
problems, without sacrificing too 
much in execution speed. 

Sidekig is threaded, but it uses 
a different model for threads than 
most Rubyists are used to. It uses 
Celluloid, an “actor-based” threading 
system that packages the threads 
inside objects, avoiding most or all 
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Moreover, Celluloid expects to run in JRuby or 
Rubinius, two alternative Ruby implementations, 
which have true threading and lack the GIL. 


of the issues associated with threads. 
Moreover, Celluloid expects to run 

in JRuby or Rubinius, two alternative 
Ruby implementations, which have 
true threading and lack the GIL. 
Celluloid-based applications, such as 
Sidekig, will work just fine under the 
standard Ruby interpreter, known as 
the MRI, but you won't enjoy all of 
the speed or threading benefits. 


Using Sidekigq 

Now, let's see how this overview of 

a delayed job can be implemented 

in Sidekiq. First and foremost, you'll 

need to install the Redis NoSQL store. 

Redis is available from a variety of 

sources; | was able to install it on my 

Ubuntu-based machine with: 

apt-get install redis # check this 
Once Redis is installed, you'll want 

to install the “sidekig” gem. Again, 

it’ll give you the best functionality if 

you run it under JRuby or Rubinius, 

but you can run It under the standard 

Ruby interpreter as well. Just realize 

that the threads will give you 
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non-optimal performance. You can 
install the gem with: 


sudo gem install sidekiq -V 


If you're running the Ruby Version 
Manager (RVM), as | do, you don’t 
want to install the gem as root. 
Instead, you should just type: 


gem install sidekiq -V 


(| always like to use the -V flag, so | 
can see the details of the gem as it Is 
installed.) 

You can use Sidekig in any Ruby 
application. However, most of my 
work is in Rails, and | imagine you're 
going to want to use it in Rails, 
Sinatra or a similar Web application. 
Thus, let’s create a simple Rails 
application so you can try it: 


rails new appointments 


Within the new “appointments” 
directory, you'll then create an 
“appointment” resource with 
scaffolding—a combination of model, 
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controller and view that can get you 
going quickly: 


rails g scaffold appointment name: text 


=»meeting at:timestamp notes:text 


Once that is done, you have to 
run the migration, creating the 
appropriate “appointments” table in 
your database. In this case, because 
you didn’t specify a database, you'll 
use SQLite, which is good enough for 
this toy example. 

Now you can fire up your 
application (rails s) and go to 
/appointments. From that URL, you 
can create, view, edit and delete 
appointments. However, the point is 
not to create appointments, but rather 
delay the execution of something 
having to do with them. Let’s do 
something extremely simple, such as 
sending e-mail: 


rails g mailer notifications 


Inside app/mailers/notifications.rb, 
add the following method: 


def appointment_info(person, appointment) 
@person = person 
@appointment = appointment 
mail(to:person.email, subject: "Appointment update") 
end 


end 


And, inside app/views/notifications/ 
appointment_info.html.erb, write the 
following: 


<p>Hello! You have an appointment with <%= @person %> 


at <%= @appointment.meeting_at %>.</p> 


Finally, let’s tie it all together, 
sending your notification from within 
your AppointmentWorker class. 
There’s no rule for where the file 
defining such a class needs to be put, 
but it seems increasingly standard 
to have it in app/workers, in part 
because files under app are all loaded 
when Rails starts up: 


class AppointmentWorker 


include Sidekiq: :Worker 


def perform(appointment) 
Notifications.deliver_appointment_info(appointment) 
end 


end 


Notice several things here. First, 
the class doesn’t inherit from 
anything special. Sidekiq doesn't 
use inheritance, but rather has 
you include a module—a class 
without instances, in Ruby—whose 
methods then are available to 
instances of your class. This is how 
the perform_async method is defined 
on your class. Through a little bit of 
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Sidekiq uses Ruby’s built-in serialization 
facility to store nearly any sort of object, 


not just numeric IDs. 


magic, importing a module can define 

both class and instance methods. 
Now all you have to do is change 

your controller, such that after 

you create a report, you also send 

a notification: 


AppointmentWorker.perform_async (@appointment) 


Notice that you're not passing 
the ID of the appointment, but the 
appointment object itself! Sidekiq 
uses Ruby’s built-in serialization 
facility to store nearly any sort of 
object, not just numeric IDs. The 
object and method call are stored in 
Redis, until they are retrieved by a 
Sidekiq process. 

Indeed, that’s the final part of 
Sidekiq that you need to get in 
place: the back-end process that 
will look through the delayed jobs, 
running each one in turn as it gets 
to them. Fortunately, running that 
iS aS easy as: 


bundle exec sidekiq 


Yup, that’s all you need to do. 


40 / MAY 2013 / WWW.LINUXJOURNAL.COM 


True, there are some options you 
can set, but generally speaking, 
this starts up a Sidekig server that 
looks at the current queue (as 
stored in Redis), grabs a job off 
the queue and processes it. You 
can configure Sidekig to run with 
a timeout or with a specified 
number of retries, and you even 
can say how many concurrent 
workers (that is, threads) you want 
to be working simultaneously. 
Remember that although these 
are indeed threads, Sidekiq (via 
Celluloid) ensures that they don’t 
have any state in common. Of 
course, you need to be sure that 
your worker methods are thread- 
safe, such that even if a worker 
gets through 90% of its job and 
is then halted, it'll be able to 
restart without any penalties or 
errors. Thus, your processes must 
be transactional, just as you would 
expect from a database query. 
There are other ways to schedule 
Sidekig jobs, besides defining 
methods within a module, as in the 
above example. If there’s an existing 
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method that you want to run as a 
background process, just insert the 
“delay” method before the actual 
method call—that is: 


my _object.delay.do_ something big 


If you are using Rails and the 
built-in ActiveSupport module for 
easy time descriptions, you even can 
do something like this: 


my_object.delay_for(5.days).do something big 


Conclusion 

Sidekiq has become quite popular 
in the Ruby community since it 

was released, in no small part 
because of its high performance, 
easy installation and ease of use. It 
also works with commercial hosting 
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services, such as Heroku, assuming 
that you first install a Redis instance. 
Working with delayed jobs 
changes your perspective of the 
Web somewhat—you realize that 
not everything needs to take place 
immediately. Rather, you can delay 
certain jobs, putting them in the 
background, allowing your Web 
server to respond to users faster 
than otherwise would be the 
case. And, when speed Is such a 
crucial element of Web application 
success, prudent use of Sidekiq 
likely will make a big difference.m™ 
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Web developer, trainer and consultant Reuven M. Lerner 

is finishing his PhD in Learning Sciences at Northwestern 
University. He lives in Modi’in, Israel, with his wife and three 
children. You can read more about him at http://lerner.co.il, 
or contact him at reuven@lerner.co.il. 


The Sidekiq home page is at http://sidekiq.org. Although Sidekig.org does point to a 


commercial version, the basic version is still free and open source, with the source code 
available on GitHub at http://mperham.github.com/sidekiq, including a Wiki containing 


a great deal of useful information. 


Mike Perham, the author of Sidekig, describes the actor-based model in a blog post: 
http://blog.carbonfive.com/2011/04/19/concurrency-with-actors. 


Finally, given that Sidekiq uses Redis, you likely will want to read more about this 


high-performance NoSQL database at http://redis.io. 
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Points 


Summing Up 


DAVE TAYLOR 


Fifteens. Why are they so important to Cribbage, and how 
do you calculate them? And what about pairs? Read on 
as Dave continues to step through the construction of a 
Cribbage game written as a shell script. 


We’re still building out the 
Cribbage game with the six-choose- 
four challenge that’s at the very 
beginning of the game when the 
players in a two-player game discard 
two of their six cards into the “crib”, 
a third hand that alternates between 
players. Think of it like playing draw 
poker, except when the players discard 
their cards, the dealer also could pick 
them up and play them as a second 
hand. That'd be weird, but interesting, 
wouldn’t it? Hmmm.... 

No, let’s stay focused! 

In my last article, we left the 
Script at a point where it was able 
to pull out all two-card, three-card 
and four-card combinations of cards 
to ascertain which of them add 
up to 15 or otherwise offer point 
opportunities. Now let’s jump in and 
actually calculate values and see 
what happens. 
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Specifically, here’s where we left off: 


$ cribbage.sh 
Hand: AD, AS, 2D, 3C, 5C; KC. 
Subhand 0: AD AS 2D 3C 

total 15-point value of that hand: 0 
Subhand 4: AD AS 3C_ KC 

total 15-point value of that hand: 2 
Subhand 14: 2D 3C 5C_ KC 

total 15-point value of that hand: 4 


If we were looking only for 
combinations that add up to 15, the 
script has identified the best possible 
combination—that of a 2, 3, 5 and 
king. The problem is, runs are worth 
lots of points too, and the run of 
AD, AS, 2D, 3C is worth AD+2+3=3, 
AS+2+3=3, and the pair of aces adds 
another 2, so that’s eight points, far 
more than the two fifteens. But, we'll 
get to that later. 

For now, let’s look at how the 
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fifteens are calculated by just 
examining the two-card case: 


for subhand in {0..5} 
do 
sum=0 
for thecard in ${fourtwo[$subhand] } 
do 
sum=$(( $sum + ${c15[$thecard]} )) 


done 
if [ $sum -eq 15 ] ; then 
points=$(( $points + 2 )) 
fi 
done 


Remember that the $fourtwo array 
is an enumerated list of all possible 
two-card combinations out of four 
(for example, 14+2, 1+3, 144, 243 
and so on). The $points variable 
accumulates how many fifteens are 
found as the function tests two- 
card, three-card and, finally, the 
one possible four-card combination, 
ending with the echo statement: 


echo " total 15-point value of that hand: $points" 


We'll tweak that as the function 
expands in capabilities, but for now, 
that’s useful. 


Calculating Pairs 
The next step is to calculate pairs. 
It turns out that we don’t need any 


additional code to calculate the value 
of three of a kind or four of a kind 
(though in years of playing Cribbage, 
| have never had four of a kind in 
my hand!), because they are unto 
themselves combinations of pairs. 
That is, if a player has 3D, 3S and 3H, 
it’s worth six points: two points for 
3D+3S, two points for 3D+3H and two 
points for 3S+3H—handy, really! 

Because the calc15() function 
(shown in my last article) already offers a 
lot of the infrastructure we'll need, we're 
just going to expand on it, even though 
it technically won't be calculating only 
15-point values any more. That's okay; 
we'll end up renaming the function, 
but for now, let's just code. 

To extract pairs, the loop is 
Slightly different: 


twocards=${fourtwo[$subhand] } 
card1=${twocards:0:1} 
card2=${twocards: 2} 


Placing this within the snippet for 
subhand in {0..5} will let us test 
all two-card combinations of the four- 
card hand given to the function. 

There's a bit of fancy variable 
referencing here too. It turns out we can 
extract substrings at a variable reference 
by using the following notation: 


${string:position: length} 
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In the first instance, card1 will 
end up being the first value in the 
twocardsvariable, which itself is 
extracted from the fourtwo[] array. 
Its format is “X Y”, so the second 
reference needs to start at 2. Being 
lazy, we just grab the rest of the 
string, which means we can omit the 
: Length parameter. 

Why have the interim variable 
twocards? Because the shell can 
figure out only a certain level of 


complexity, and writing something like: 


${{fourtwo[$subhand] }:0:1} 


just gives me a headache. 

The next step is simply to compare 
the two cards and see if they’re the 
same rank: 


if [ ${c15[$card1]} = ${c15[$card2]} ] ; then 


echo "we've got a pair: ${c15[$card1]} and ${c15[$card2]}" 


This all looks good, but there’s 
a glaring bug In the code, as is 
immediately obvious with some 
debugging info: 


Subhand 14: 9S 10H JH KD 

calci5() given ranks: 9 10 10 10 

PAIRS: testing two cards © and 1 from @ 1 
PAIRS: testing two cards 0 and 2 from © 2 
PAIRS: testing two cards 0 and 3 from @ 3 
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PAIRS: testing two cards 1 and 2 from 1 2 
we've got a pair: 10 and 10 
PAIRS: testing two cards 1 and 3 from 1 3 
we've got a pair: 10 and 10 
PAIRS: testing two cards 2 and 3 from 2 3 


we've got a pair: 10 and 10 


The problem is that calc15() is being 
given the ranks of the cards after they've 
been scrubbed to just point values, so 
a 10H, JH and KD all look like they are 
point value 10. That works great for 
calculating fifteens, but a 10H+KD is 
most assuredly not a valid pair. 

The fix is easy. We can just have 
calc15() get both the four normalized 
ranks and the four original ranks as 
parameters. Recall that in the function 
handvalue4() ranks are normalized 
through code blocks like this: 


# now fix rank to normalize for value=10 
case $rl in 

11|12|13) nri=10 ;; 

*) nri=$ri1 ;; 
esac 


So $ri1 already is the proper rank 
of the first card (that is, 1-13), and 
$nri1 is the normalized rank (where 
a 10 and a K have value 10). Then, 
invoking calc15() is just a tiny bit 
more complex: 


calc15 $nri1 $nr2 $nr3 $nr4 $r1 $r2 $r3 $r4 
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For notational convenience, let’s also 
grab the 5th-8th parameters and reassign 
them into a local array $cr15[] like this: 


cr15[0]=$5; cr15[1]=$6; cr15[2]=$7; cr15[3]=$8 


Now the fix to calculate proper pairs 
is quite easy: 


Subhand 14: 10S JS QC QD 
calc15() given ranks: 10 10 10 10 


PAIRS: testing two cards © and 1 from 0 1 
PAIRS: testing two cards © and 2 from 0 2 
PAIRS: testing two cards © and 3 from 0 3 
PAIRS: testing two cards 1 and 2 from 1 2 
PAIRS: testing two cards 1 and 3 from 1 3 
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PAIRS: testing two cards 2 and 3 from 2 3 


we've got a pair: 12 and 12 

And, I’m out of space for this article. 
In my next article, we'll continue 
expanding on the pair calculations and 
add the final piece we need before we 
can actually clean it up and pick the 
best four out of six cards: testing for a 
flush, the situation where all four cards 
are of the same suit.m@ 


Dave Taylor has been hacking shell scripts for more than 30 years. 
Really. He’s the author of the popular Wicked Cool Shell Scripts 
and can be found on Twitter as @DaveTaylor and more generally 


at http://www.DaveTaylorOnline.com. 
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Two Pi R 


KYLE RANKIN 


Raspberries are found in clusters, so why not 
Raspberry Pis? Kyle starts a series on building 
a redundant Raspberry Pi cluster. 


Although many people are 
excited about the hardware-hacking 
possibilities with the Raspberry Pi, 
one of the things that interests me 
most is the fact that it is essentially 
a small low-power Linux server | can 
use to replace other Linux servers | 
already have around the house. In 
previous columns, I’ve talked about 
using the Raspberry Pi to replace 
the server that controls my beer 
fridge and colocating a Raspberry 
Pi in Austria. After | colocated a 
Raspberry Pi in Austria, | started 
thinking about the advantages and 
disadvantages of using something 
with so many single points of 
failure as a server | relied on, so 
| started thinking about ways to 
handle that single point of failure. 
When you see “Two Pi R”, you 
probably think the R stands for 
the radius for a circle. To me, it 
stands for redundancy. | came to 
the conclusion that although one Pi 
isn’t redundant, two Pi are. 

So, in this article, I’m building 
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the foundation for setting up 
redundant services with a pair of 
Raspberry Pis. | start with setting 
up a basic clustered network 
filesystem using GlusterFS. In later 
articles, I'll follow up with how 

to take advantage of this shared 
storage to set up other redundant 
services. Of course, although I’m 
using a Raspberry Pi for this article, 
these same steps should work with 
other hardware as well. 


Configure the Raspberry Pis 

To begin, | got two SD cards 

and loaded them with the latest 
version of the default Raspberry 

Pi distribution from the official 
Raspberry Pi downloads page, the 
Debian-based Raspbian. | followed 
the documentation to set up the 
image and then booted in to both 
Raspberry Pis while they were 
connected to a TV to make sure that 
the OS booted and that SSH was set 
to start by default (it should be). 
You probably also will want to use 
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GlusterFS is a userspace clustered filesystem that 
| chose for this project because of how simple it 
makes configuring shared network filesystems. 


the raspi-config tool to expand the netmask 255.255.255.0 

root partition to fill the SD card, gateway 192.168.0.1 

since you will want all that extra 

space for your redundant storage. Of course, modify the networking 
After | confirmed | could access information to match your personal 


the Raspberry Pis remotely, | moved network, and make sure that each 
them away from the TV and over to Raspberry Pi uses a different IP. 
a switch and rebooted them without | also changed the hostnames of 


a display connected. each Raspberry Pi, so | could tell 
By default, Raspbian will get its them apart when | logged in. To 
network information via DHCP; do this, Just edit /etc/hostname as 
however, if you want to set up root and change the hostname to 
redundant services, you will want what you want. Then, reboot to 
your Raspberry Pis to keep the make sure that each Raspberry Pi 


same IP every time they boot. In my comes up with the proper network 
case, | updated my DHCP server so settings and hostname. 

that it handed out the same IP to 

my Raspberry Pis every time they Configure the GlusterFS Server 
booted, but you also could edit the GlusterFS is a userspace clustered 
/etc/network/interfaces file on your _ filesystem that | chose for this 


Raspberry Pi and change: project because of how simple it 
makes configuring shared network 
iface ethO inet dhcp filesystems. To start, choose a 
Raspberry Pi that will act as your 
to: master. What little initial setup you 
need to do will be done from the 
auto ethd master node, even though once 
iface ethO inet static things are set up, nodes should 
address 192.168.0.121 fail over automatically. Here is the 
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information about my environment: 


Master hostname: pil 

Master IPs 192,166, 0.121 
Master brick path: /srv/gv0 
Secondary hostname: pi2 
192.168:0,122 
/srv/gvO 


Secondary IP: 
Secondary brick path: 


Before you do anything else, log in 
to each Raspberry Pi, and install the 
glusterfs-server package: 


$ sudo apt-get install glusterfs-server 


GlusterFS stores its files in what 
it calls bricks. A brick is a directory 
path on the server that you set 
aside for gluster to use. GlusterFS 
then combines bricks to create 
volumes that are accessible to 
clients. GlusterFS potentially can 
stripe data for a volume across 
bricks, so although a brick may 
look like a standard directory full 
of files, once you start using it with 
GlusterFS, you will want to modify 
it only via clients, not directly on 
the filesystem itself. In the case of 
the Raspberry Pi, | decided just to 
create a new directory called 
/srv/gvO for my first brick on both 
Raspberry Pils: 


$ sudo mkdir /srv/gvO 
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In this case, | will be sharing my 
standard SD card root filesystem, 
but in your case, you may want 
more storage. In that situation, 
connect a USB hard drive to each 
Raspberry Pi, make sure the disks 
are formatted, and then mount 
them under /srv/gvO. Just make 
sure that you update /etc/fstab so 
that it mounts your external drive 
at boot time. It’s not required that 
the bricks are on the same directory 
path or have the same name, but 
the consistency doesn’t hurt. 

After the brick directory is available on 
each Raspberry Pi and the glusterfs-server 
package has been installed, make 
sure both Raspberry Pis are powered 
on. Then, log in to whatever node 
you consider the master, and use the 
gluster peer probe command 
to tell the master to trust the IP or 
hostname that you pass it as a member 
of the cluster. In this case, | will use the 
IP of my secondary node, but if you are 
fancy and have DNS set up, you also 
could use its hostname instead: 


pi@pil ~ $ sudo gluster peer probe 192.168.0.122 


Probe successful 


Now that my pil server 
(192.168.0.121) trusts pi2 
(192.168.0.122), | can create my first 
volume, which | will call gvO. To do this, 
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lrun the gluster volume create 
command from the master node: 


pi@pil ~ $ sudo gluster volume create gv@ replica 2 
™192.168.0.121:/srv/gv0 192.168.0.122:/srv/gv0 
Creation of volume gvO has been successful. Please start 


the volume to access data. 


Let's break this command down a 
bit. The first part, gluster volume 
create, tells the gluster command I’m 
going to create a new volume. The next 
argument, gv0, is the name | want to 
assign the volume. That name is what 
clients will use to refer to the volume 
later on. After that, the replica 2 
argument configures this volume to 
use replication instead of striping data 
between bricks. In this case, it will make 
Sure any data Is replicated across two 
bricks. Finally, | define the two individual 
bricks | want to use for this volume: the 
/srv/gvO directory on 192.168.0.121 and 
the /srv/gvO directory on 192.168.0.122. 

Now that the volume has been 
created, | just need to Start it: 


pi@pil ~ $ sudo gluster volume start gv0 
Starting volume gvO has been successful 


Once the volume has been started, 
| can use the volume info command 


on either node to see its status: 


$ sudo gluster volume info 


Volume Name: gv0 
Type: Replicate 
Status: Started 
Number of Bricks: 2 
Transport-type: tcp 


Bricks: 
Bricki: 192.166 .0.1217/sfrv/gv0 
Brick2; 192.166.0,122;7/sfv/ evo 


Configure the GlusterFS Client 
Now that the volume Is started, | can 
mount it as a GlusterFS type filesystem 
from any client that has GlusterFS 
support. First though, | will want to 
mount it from my two Raspberry Pis 
as | want them to be able to write to 
the volume themselves. To do this, | 
will create a new mountpoint on my 
filesystem on each Raspberry Pi and 
use the mount command to mount 
the volume on it: 


$ sudo mkdir -p /mnt/gluster1 


$ sudo mount -t glusterfs 192.168.0.121:/gv® /mnt/gluster1 


$ df 

Filesystem 1K-blocks Used Available Use% Mounted on 
rootfs 1804128 1496464 216016 88% / 
/dev/root 1804128 1496464 216016 88% / 
devtmpfs 86184 (0) 86184 0% /dev 
tmpfs 18888 216 18672 2% /run 
tmpfs 5120 (0) 5120 0% /run/lock 
tmpfs 37760 (0) 37760 0% /run/shm 
/dev/mmcb1kOp1 57288 18960 38328 34% /boot 


192.168.0.121:/gv0 1804032 1496448 215936 88% /mnt/gluster1 
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Since | want to make sure that I could take down 
either of the two nodes and still have access to 
the files, | configured a separate client to mount 


this GlusterFS volume. 


The more pedantic readers among 


you may be saying to yourselves, 
“Wait a minute, if | am specifying 
a specific IP address here, what 
happens when 192.168.0.121 goes 
down?” It turns out that this IP 
address is used only to pull down 
the complete list of bricks used in 
the volume, and from that point 
on, the redundant list of bricks is 
what will be used when accessing 
the volume. 

Once you mount the filesystem, 
play around with creating files and 
then looking into /srv/gvO. You 
should be able to see (but again, 
don’t touch) files that you've 
created from /mnt/gluster1 on the 
/srv/gvO bricks on both nodes in 
your cluster: 


pi@pil ~ $ sudo touch /mnt/gluster1/test1 
pi@pil ~ $ ls /mnt/gluster1/test1l 
/mnt/gluster1/testl 

pi@pil ~ $ ls /srv/gvO 

testi 

pi@pi2 ~ $ ls /srv/gvO 

testl 
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After you are satisfied that you 
can mount the volume, make it 
permanent by adding an entry like 
the following to the /etc/fstab file 
on your Raspberry Pis: 


192.168.0.121:/gvO /mnt/gluster1 glusterfs defaults, netdev 0 0 


Note that if you also want to 
access this GlusterFS volume from 
other clients on your network, 
just install the GlusterFS client 
package for your distribution (for 
Debian-based distributions, it’s 
called glusterfs-client), and then 
create a mountpoint and perform 
the same mount command as | 
listed above. 


Test Redundancy 

Now that | have a redundant 
filesystem in place, let’s test it. 
Since | want to make sure that | 
could take down either of the two 
nodes and still have access to the 
files, | configured a separate client 
to mount this GlusterFS volume. 
Then | created a simple script called 
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glustertest inside the volume: 
#!/bin/bash 


while [ 1 ] 

do 
date > /mnt/glusterl1/testl 
cat /mnt/glusterl/testl 
sleep 1 

done 


This script runs in an infinite loop 
and just copies the current date into 
a file inside the GlusterFS volume 
and then cats it back to the screen. 
Once | make the file executable and 
run it, | should see a new date pop 
up about every second: 


# chmod a+x /mnt/gluster1/ 


glustertest 

root@moses:~# /mnt/gluster1/ 
glustertest 

Sat.MNar 28. 13719°02 Pol 2015 
Sat Mar 9 13:19:04 PST 2013 
Sat. Mar & 13: 129°05 PST 2013 
Sat Mar 9 13:19:06 PST 2013 
Sat’ Mar 2.13719: 07 Psi 2015 
Sat. Mar 9 137° 19708: Pal 2013 


| noticed every now and then that 
the output would skip a second, 
but in this case, | think it was just a 
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function of the date command not 
being executed exactly one second 
apart every time, so every now and 
then that extra sub-second it would 
take to run a loop would add up. 
After | started the script, | then 
logged in to the first Raspberry Pi 
and typed sudo reboot to reboot 
it. The script kept on running just 
fine, and if there were any hiccups 
along the way, | couldn’t tell it 
apart from the occasional skipping 
of a second that | saw beforehand. 
Once the first Raspberry Pi came 
back up, | repeated the reboot on 
the second one, just to confirm 
that | could lose either node 
and still be fine. This kind of 
redundancy is not bad considering 
this took only a couple commands. 
There you have it. Now you 
have the foundation set with a 
redundant file store across two 
Raspberry Pis. In my next column, 
| will build on top of the 
foundation by adding a new 
redundant service that takes 
advantage of the shared storage. 


Kyle Rankin is a Sr. Systems Administrator in the San Francisco 
Bay Area and the author of a number of books, including The 
Official Ubuntu Server Book, Knoppix Hacks and Ubuntu Hacks. 
He is currently the president of the North Bay Linux Users’ Group. 
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SHAWN POWERS 


Be prepared for the Google Reader shutdown! 


And the Google taketh away. So 

it is with Google Reader. A while 
back, Google discontinued its Google 
Wave product, because it never 
gained traction as a social-media 
platform. This surprised approximately 
zero people. More recently, Google 
announced it would be closing 
Google Reader on July 1, 2013. Far 
more people were surprised, myself 
included. In this article, | want to 
explore some options for those about 
to be left in the lurch. 


Those Clouds Look Ominous 

| think even more interesting than 
Google eliminating Google Reader 
is the collateral damage it’s doing to 
cloud computing in general. Reader 
is something I’ve used for years, 
depended on in fact, to keep up 
with the Web sites | find interesting. 
Google Reader is a program I'd 
happily pay for, but since it’s 

free, I've always just counted my 
blessings and moved on. Now that 
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it’s disappearing, my dependence on 
free and/or cloud-based services is 
weighing heavily on me. Today It’s 
Google Reader; will tomorrow be the 
end of Dropbox? Flickr? Google Mail? 

Since Google’s announcement 
regarding the demise of Reader, I’ve 
visited SourceForge and Github more 
frequently than | have in years. | don’t 
like Google being able to affect my 
day-to-day computing so dramatically 
on a whim, and so I’ve been working 
hard to make myself less dependent 
on services like Google Reader. This is 
the first in what | expect might be a 
series of articles on self-sufficiency in 
this cloudy new world. 


Web Shmeb 

The simplest way to avoid losing your 
cloud-based solutions is to avoid 
Web-based services altogether. Before 
the original Web applications like 
Bloglines and Google Reader came 
about, people were perfectly happy 
with standalone RSS readers. Many 
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Figure 1. Liferea is simple, but that’s not a bad thing. 


folks still use a standalone application, Because it has the ability to sync with 


and if you tend to browse the Web a back-end database, Liferea can 
from the same computer all the time, provide the best of both worlds— 

a standalone application might be the namely, a local application for 

perfect solution. browsing RSS feeds, plus syncing with 


Liferea is a Linux-native application a common back end for reading on 
that does a nice job of managing RSS other devices and computers. Liferea 
feeds (http://Izone.de/liferea). Like has a simple interface, but if you 


almost every other RSS application, want to burn through your RSS feeds, 
it syncs with Google Reader, but simple is good (Figure 1). 

thankfully, it also syncs with Tiny Tiny Tons of other RSS clients work 

RSS (more on Tiny Tiny RSS later). very well under Linux—Akregator, 
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Even in light of Google shutting down its 
much-beloved Reader Application, as long 
as you keep your eyes wide open, there’s 
nothing wrong with using on-line services— 
just be ready for them to disappear. 


Thunderbird, RSSOwl and many 
others. | specifically mention Liferea 
because of its ability to sync with 
Tiny Tiny RSS, but plenty of perfectly 
usable RSS readers are available. 
Check apt-get or your distro’s 
equivalent for “RSS” and you should 
find several. 


Read RSS in Your Browser! 

| know it seems like circular logic, but 
Web browsers can do so much more 
than browse Web sites. Anyone with 

a Chromebook can attest to how 
powerful a browser can be. Firefox has 
extensions like Sage, Brief or Simple RSS 
Reader. | could show them all in action, 
but really, | just recommend going 

to http://addons.mozilla.org and 
searching for “RSS”. See which ones 
look appealing, and give them a try! 

If you fall on the Google Chrome 
(or Chromium) side of the fence, 
there are plenty of Chrome extensions 
for RSS feed-reading as well. Slick 
RSS, Feed Reader and several others 
exist. Google also supplies the RSS 
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Subscription Extension, which allows 
you to add feeds to your Web-based 
subscription service directly from 

the Web site you'd like to add. It 
recently removed Google Reader as a 
destination, which makes sense, but 
other options are available, which 
leads me to the next possibility. 


Third Cloud to the Right 

Before | talk about hosting your 
own solution, | think it’s only fair to 
discuss a few other options available 
from third parties. Even in light of 
Google shutting down its much- 
beloved Reader Application, as long 
as you keep your eyes wide open, 
there’s nothing wrong with using 
on-line services—just be ready for 
them to disappear. 

Feedly: Arguably the most popular 
“alternative” to Google Reader is 
Feedly (http://www.feedly.com). 

In a slightly ironic twist, Feedly uses 
Google Reader as its back-end API for 
keeping your RSS feeds in sync across 
devices. Feedly was designed as a 
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POPULAR 


Figure 2. Feedly has many cross-platform clients, plus 
it works on the Web. 


front end to Google Reader, but from 
a user's perspective, it’s an alternative. 
The Feedly folks have announced 
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they will be transitioning 
users seamlessly from the 
Google Reader back end 
to whatever their new 
platform will be. It’s still 

a testament to how much 
people (even companies) 
depend on free services to 
remain available. 

Feedly takes a far more 
visual approach to RSS 
feeds, and by default, 
it presents a magazine- 
like view of Web stories. 
(See the Feedly Android 
client in Figure 2.) Some 
people really like this, 
and it seems to be a 
trend for RSS readers of 
late. Personally, | find 
it annoying, but | can 
see the appeal. Feedly is 
free, but it soon will be 
offering a “pro” version 
that supports off-line 
browsing. 

The Old Reader: If the 
new flipboard/magazine 
look offends your very 
being, another on-line 
alternative to Reader 
is The Old Reader 


(http://theoldreader.com). | suspect 
it's not a coincidence that the interface 
to The Old Reader looks almost 
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Figure 3. The Old Reader looks like, well, The Old Google Reader! 


identical to how Google Reader looked 

in the old days (Figure 3). It appears to 

be completely free, which I’d normally 

consider a good thing, but thanks to 

Google, I’m gun-shy about such things 

now. Nonetheless, The Old Reader 

can import your Google Reader feeds, 

and it functions almost exactly like the 

Google Reader of old (with at least one 

major exception, which | discuss later). 
The Old Reader doesn’t import 

Google Reader subscriptions 

automatically, but it does allow 

the import of a subscription file 

in the format Google provides. 

Because The Old Reader doesn't 

use Google Reader as its back end, 


58 / MAY 2013 / WWW.LINUXJOURNAL.COM 


the demise of the latter shouldn't 
affect the former. It is possible that 
the mass exodus of Google Reader 
users will have an adverse affect on 
performance, but hopefully that can 
be overcome. 

NewsBlur: NewsBlur is an interesting 
contender for “Google Reader 
Replacement”. It is a fully open-source 
program, but the service provided 
from http://www.newsblur.com 
offers a very restricted “free” 
offering. | want to like NewsBlur, 
especially based on its open 
nature, but the free offering is 
so limited (it limits the number 
of feeds you can add), it’s hard 
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Figure 4. NewsBlur has a great interface, there’s no denying it. 


to test it long enough to justify Reader going away really disrupts 
the subscription fee. Like Feedly, my lifestyle, and | want to make 
NewsBlur offers a more “exciting” sure I’m not setting myself up for 
interface for browsing your feed failure by choosing another third- 
(Figure 4). If you prefer that sort of | party service. 
look, NewsBlur is worth checking My first attempt at replacing 
out. The open-source reality of Google Reader was to Install my 
NewsBlur brings me to the next and own copy of NewsBlur. It’s a little 
final section. more glitzy than | like, but it’s 
open source. | fired up my Web- 
Make Your Own Cloud hosting service and created a new 
Although I’m not quite ready to site for hosting NewsBlur—and 
abandon Gmail and host my own then spent hours beating my head 
e-mail again, | have to admit I’ve against the wall. 
been researching my options ever Don’t get me wrong, NewsBlur 
since the announcement of Google is indeed open source. The code Is 
Reader’s demise. For my RSS needs, freely available from GitHub. There 
however, I’ve decided to host my are installation instructions, but 


own Web-based RSS reader. Google _ it’s still fairly difficult to install. | 
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Tiny Tiny RSS reminds me more of a standalone 
RSS reader like Liferea than a Web-based 
program, but when you start exploring its plugins 
and addons, you might wonder why you’ve been 
using Google Reader all this time! 


understand developers not devoting 
a ton of time holding people’s virtual 
hands for an end result that would 
cut directly into their bottom line 
(NewsBlur is a commercial service 
after all). Still, if you're thinking you 
just need a simple LAMP stack, you'll 
be very surprised. 

NewsBlur depends on Django, 
Celery, RabbitWQ, MongoDB, 
Pymongo, Fabric, jQuery, PostgreSQL 
or MySQL, and tons of configuration 
to get it running. I’m not saying 
the program is poorly designed. I'm 
saying that I’m lazy, and installations 
like WordPress have spoiled me. 

If you're adventurous enough, 
installing your own instance of 
NewsBlur may be very rewarding. | 
prefer something simpler if | need to 
maintain it, however. Enter: Tiny Tiny 
RSS (http://tt-rss.org/redmine). 

Tiny Tiny RSS: Like the name 
implies, Tiny Tiny RSS is small. It’s a 
PHP application that requires a back- 
end MySQL database and nothing else. 
It literally took less than five minutes 
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for me to install and configure Tiny 
Tiny RSS on my Web server (Figure 5). 
Tiny Tiny RSS reminds me more of 
a standalone RSS reader like Liferea 
than a Web-based program, but 
when you start exploring its plugins 
and addons, you might wonder 
why you've been using Google 
Reader all this time! If you recall, 
at the beginning of this article, 
| mentioned that Liferea would 
sync with Tiny Tiny RSS. When 
you add the fact that it can act as 
a back end to standalone clients, 
the availability of an Android 
application and the countless 
plugins available, it’s easy to fall in 
love with Tiny Tiny RSS. Even if you 
end up going with a more glitzy 
alternative, you owe it to yourself 
to give Tiny Tiny RSS a try. 


Sadly, Nobody Surfs Like Me 
I'm doing my best to focus on the 
positive side effects of Google’s 
decision to close down Google 
Reader. It’s forced me (and many 
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Figure 5. Tiny Tiny RSS is tiny, and it interfaces with plugins and clients alike. 


others) to take a serious look at 
where I’m putting my data, plus 
it's forced me to think outside 
my little box. In all my research, 
however, | still haven't found a way 
to replicate the obscure Google 
Reader feature that has been my 
sole way to browse the Internet for 
a half decade—the “next unread” 
bookmarklet. | demonstrated the 
feature in a Linux Journal Tech Tip years 
ago: http://www.youtube.com/ 
watch?v=ILGqEsVDPrqQ. 

Maybe someone will create a 
Tiny Tiny RSS plugin that does 
this for me. Maybe it will be the 


reason | finally learn to program 
on my own. Nevertheless, this 
seemingly simple feature is one | 
can't find anywhere else. If anyone 
has recommendations on how to 
replicate that feature, or if there 
are any Tiny Tiny RSS programmers 
out there looking for a weekend 
project, I’d love to hear about it! m™ 


Shawn Powers is the Associate Editor for Linux Journal. He's 
also the Gadget Guy for LinuxJournal.com, and he has an 
interesting collection of vintage Garfield coffee mugs. Don’t let 
his silly hairdo fool you, he’s a pretty ordinary guy and can be 
reached via e-mail at shawn @linuxjournal.com. Or, swing by 
the #linuxjournal IRC channel on Freenode.net. 


WWW.LINUXJOURNAL.COM / MAY 2013 / 61 


THE OPEN-SOURCE CLASSROOM 


NEW PRODUCTS 


NeuroSky’s Brainwave 
Starter Kit eenenie 


Another inch toward a Star Trek reality comes in the $gg' 99 pe 
form of NeuroSky’s Brainwave Starter Kit, a brain- 


computer interface package that lets users analyze Brainwave 
and visualize their own brain waves on Android and Starter Ait 
iOS. Users simply slip on the MindWave Mobile EEG gasses 
headset and view their own brainwaves displayed on a 
their handset in the colorful Brainwave Visualizer. iaé A 


The brain waves visibly change in real time, as one 

chills out to relaxing music and then does some intensive programming or imagines 
something Marvin Gaye sings about. The MindWave Mobile safely measures and 
outputs the EEG power spectra (alpha waves, beta waves and so on), NeuroSky eSense 
meters (attention and meditation) and eye blinks. The device consists of a headset with 
an ear clip and a sensor arm. The headset’s reference and ground electrodes are on the 
ear clip, and the EEG electrode is on the sensor arm, resting on the forehead above the 
eye. Next up: when will someone finally make a transporter? 
http://www.neurosky.com 


— _ Open-E Data Storage 
_- Software V7 


The model for the Open-E Data Storage Software is 
ee an all-in-one universal storage system that allows 
businesses of all sizes to leverage off-the-shelf 
servers to build and operate virtualized storage 
infrastructure. The Linux-based Open-E DSS V7 data 
| storage software is used for building and managing 
centralized data storage servers—NAS and SAN—and now includes Hyper-V Cluster 
Support, as well as the new product Open-E Multiple Storage Server Manager for 
simplified central management of all storage resources. Built-in enterprise-class 
features include active-active failover, active-passive failover, volume replication, 
snapshots and continuous data protection, among others. 

http://www.open-e.com 
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NEW PRODUCTS 


AdaCore GNAT Pro 
Safety-Critical for 
ARM Processors 


‘aCore 


In response to the increasing prevalence of low-cost, low-power ARM processors in 
the aerospace, defense and transportation industries, AdaCore has developed the 
GNAT Pro Safety-Critical product for ARM Cortex micro-controllers. This bareboard 
GNAT Pro Safety-Critical product provides a complete Ada development environment 
(or Eclipse plugin) oriented toward systems that are safety-critical or have stringent 
memory constraints. Developers of such systems, says AdaCore, now can exploit 

the software engineering benefits of the Ada language, including reliability, 
maintainability and portability. The ARM platform adds to the GNAT Pro Safety-Critical 
product offering, which already is available for PowerPC and LEON boards, allowing 
easy portability among all three platforms. The technology does not require any 
underlying operating system, so it can be deployed on very small memory boards. 
http://www.adacore.com 


Little Apps’ Little 
Software Stats 


The big news from Little Apps is a. 

Little Software Stats, a new open- Re 
source software package that enables i 
software developers to track how ——— = 


users are using their software. Little 
Apps says that Little Software Stats 

is the first program for obtaining 
runtime intelligence that is both open 
source and free. Because the program 
is designed and developed using 
MySQL and PHP, most Web servers 
can run it. Information that can be 
gathered includes executions, installations, exceptions and geographical location. 
http://little-apps.org 
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NEW PRODUCTS 


Rakhitha Nimesh Ratnayake’s Building Pie 
Impressive Presentations with cones 
Impress.js (Packt Publishing) Dung tesa 


Presentations with Impress.js 


Impress.js is a classic Open-source project. The closed-source world creates 
a slick app—in this case, the Prezi presentation tool—and charges much 
more than free. Next, creative (and cheapskate) open-source developer says “| want that, and | 
want it free” —in this case, Impress.js. Impress.js, not to be confused with OpenOffice.org Impress, 
is a free and open-source JavaScript library inspired by Prezi that utilizes the CSS3 transitions 
found in modern Web browsers. If this sounds interesting, the path to mastery can be found 
with Rakhitha Nimesh Ratnayake’s new book Building Impressive Presentations with Impress.js. 
Ratnayake explores the features of Impress.js, which allows one to create presentations inside 
the infinite canvas of modern Web browsers that work anywhere, any time and on any device. 
Readers will learn how to build dynamic presentations with rotation, scaling, transforms and 
3-D effects. Advanced users will find out how to extract the power of Impress.js core API events 
and configurations to modify existing functionalities, as well as extend the core library to create 
custom functionalities for different types of applications, such as sliders, portfolios and galleries. 
http://www.packtpub.com 


David M. Bourg, Kenneith Humphreys 
and Bryan Bywalec’s Physics for 
Game Developers, 2nd edition 
(O’Reilly Media) 


» Whether or not game development is your vocation, you have to admit 
the material in Physics for Game Developers, 2nd edition, is inherently 
super interesting. In this book, the authors explore the key knowledge 
behind bread-and-butter game physics that go into modern games for Nintendo Wii, PlayStation 
Move, Microsoft's Kinect and various mobile devices. Readers also learn how to leverage exciting 
interaction gadgets, such as accelerometers, touch screens, GPS receivers, pressure sensors 
and optical tracking devices. The updated 2nd edition includes new chapters on deformable 
and soft bodies, fluids and the physics of sound for incorporating realistic effects, including 
3-D sound. Major topics include digital physics, the physics of sound, rigid body mechanics, 
fluid dynamics and the modeling of specific systems based on real-world examples. 
http://oreilly.com 


AT mS 
{OG een 


Physics 
Game Developers 


O'REILLY* 
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NEW PRODUCTS 


Z—AvNNEphaes vanDyke Software SecureFX 


SOFTWARE 


VanDyke Software says that many of its customers run 
Windows just so they don’t have to give up the wide range of functionality found on its 
SecureFX secure file transfer client. Now Linux and Mac OS X users can enjoy that same 
functionality natively with the new SecureFX 7.1, which delivers features like multiple 
file transfer protocols, site synchronization and easy recovery of interrupted transfers. 
Secure file transfers can be performed with SFTP, FTP over SSL and SCP; FTP is provided 
for use on legacy systems. Aesthetics also are important for VanDyke, which offers a 
tabbed visual user interface in SecureFX 7.1 allowing for easy learning and organizing 
for optimum productivity. Also new in SecureFX 7.1 is a dependent session option 
that can be used to link a session to an SSH2 session that it depends on, which allows 
connection to a jump host before connecting to other sessions. 
http://www.vandyke.com 


Copernica Marketing 
Software’s MailerQ 


MailerQ is a high-performance mail transfer agent 
designed to do one thing: deliver e-mail at blazing 


speed. Leveraging RabbitMQ to send up to 10,000 é : i 
e-mail messages per minute, MailerQ is targeted 
at users who want the functionality of programs seat ispa2 15Pe. 


like Port25‘s PowerMTA but can’t stomach its high 

price. With MailerQ, users are limited only by the ability to process incoming e-mail 
at the receiving end. The application puts e-mail messages in a queue and enables 
its users to manage these messages themselves and change parameters, such as send 
rate per receiving domain or IP or the number of delivery attempts. To be as efficient 
as possible, MailerQ stores messages in Couchbase NoSQL, which allows the retrieval 
of content only when an SMTP connection has been established, thus reducing the 
amount of data being passed back and forth in RabbitMWQ message queues. 
http://www.mailerg.com 


Please send information about releases of Linux-related products to newproducts@linuxjournal.com or 


New Products c/o Linux Journal, PO Box 980985, Houston, TX 77098. Submissions are edited for length and content. 
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RASPBERRY 


Pi: 


THE PERFECT 
HOME SERVER 


Exploit the Raspberry Pi’s unique low-power and 
energy-efficient architecture to build a full-featured 
home backup, multimedia and print server. 


BRIAN TRAPP 
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ver since the 
announcement of the 
Raspberry Pi, sites all 
across the Internet have offered 
lots of interesting and challenging 
uses for this exciting device. Although 
all of those ideas are great, the 
most obvious and perhaps least 
glamorous use for the Raspberry 
Pi (RPi) is creating your perfect 
home server. 

If you've got several 
different computers in need of 
a consistent and automated 
backup strategy, the RPi can 
do that. If you have music and 
video you'd like to be able to 
access from almost any screen 
in the house, the RPI can make 
that happen too. Maybe you have 
a printer or two you'd like to share 
with everyone easily? The Raspberry 
Pi can fill all those needs with a 
minimal investment in hardware and time. 
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Pacer 


Low cost: for $35, the RPi model B 
is nearly a complete computer with 
512MB of RAM, 100Mb Ethernet, 
an SD card slot, two USB ports, 
audio out and HDMI or RCA video 
out. I've seen HDMI cables that cost 
more than that. 

Energy efficient: hardware costs 
are only one component of a 
server's expense, because you also 
need to consider the energy cost to 
keep the device running constantly. 
The services needed for home use 
aren’t going to tax the CPU much, 
and most of the time it will just 
be idling, waiting for something 
to do. The RPi's ultra-low power 
components are a perfect fit for this 
workload, which helps keep your 
power bill down. My model B unit 
plus external hard drive consume 
only 8 watts total, while the old 
Athlon-based box it replaced drew 
54 watts at idle. Assuming 10 cents 
per kilowatt hour, that puts the 
yearly power bill for an RPi at $7 vs. 
$47 for an Athlon-based machine. 
The RPi basically pays for itself in 
less than a year! 

Low noise: because the RPi 
doesn’t have fans or moving parts, 
the only component in your final 
configuration that generates noise or 
any appreciable heat will be the hard 
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es: 


Figure 1. A Compact, but Highly Capable 
Home Server 


disk. If you're concerned about noise, 
enthusiast sites like Silent PC Review 
(http://www.silentpcreview.com) 
often include noise benchmarks 

in their storage reviews. My 
experience is that any modern 
drive is quiet enough to avoid 
detection anywhere there's 
something else already running 
(such as a media center, gaming 
console or other computer). If 
your home doesn’t provide a lot of 
flexibility for wiring options, the 
RPi’s small size, minimal thermal 


output and low-noise footprint 
may make it possible to sneak in 
a server where it was difficult to 
justify one in the past. 

New opportunities: a less tangible 
benefit is the simple joy of trying 
something new! For me, this was 
my first time really working ona 
Debian-based distribution, and it’s 
probably the first time many Linux 
enthusiasts will have a chance to try 
an ARM-based architecture. 


Arranging the Hardware 

For a home server, you'll need a 
medium-size SD Flash card for local 
storage. It’s possible to use a USB 
thumbdrive for booting, but that 
would use up one of the two precious 
USB slots. The Flash storage card 
doesn't need to be large, but the 
faster the better. | chose a name- 
brand SD card with an 8GB capacity 
and class 10 speed rating. For backups 
and multimedia files, a large hard 
drive with a USB dock is a must. 

| chose a 1.5TB hard drive and a 
Calvary EN-CAHDD-D 2-bay USB 

2.0 hard drive dock. This dock has a 
feature to run two drives in RAID-O 
mode, which could be useful someday. 
Finally, the RPi doesn’t come with a 
power supply, but most smartphone 
chargers supply the required 
5v-over-micro USB. To see if the RPi 


was fussy about the power source, 

| swapped through three different 
micro-USB cell-phone chargers for 
power supplies. | tried each one for 
about a week, with no issues on any 
of the units. 


Installing the Operating System 
Installing the RPi operating system 
is covered in extensive detail 
elsewhere, but here are a few 
home-server-specific tips, roughly 
in the order needed. 

1) Get the Raspbian “Wheezy” 
install image directly from 
http://www.raspberrypi.org/ 
downloads, and copy it onto the SD 
card, using the steps listed on the site. 

2) When booting the RPi for the 
first time, attach a keyboard, mouse 
and monitor. Don’t forget to turn on 
the monitor before booting the RPi, so 
that it can detect the correct HDMI or 
composite output port. 

3) The RPi has a nice “raspi-config” 
screen that you'll see on first boot. 
For a home server, the following 
selections will be useful: 


M expand_rootfs: resizes the default 
2GB OS image to fill the rest of the 
Flash card. 


mM change_pass: the default password 
is “raspberry”, but something more 
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secure than that would be better. 
m Set your locale and timezone. 


mM memory_split: assign the minimum 
amount possible (16) to the GPU 
to leave as much room as possible 
for services. 


m SSH: don’t forget to enable the 
SSH server. 


@ boot_behaviour: turn off boot to 
desktop (again, to save memory 
for your services). 


When finished, you'll be at the 
pi@raspberrypi prompt. The setup 
script can be re-run at any time via 
sudo raspi-config. 

There are just a few more 
configuration items, and then the 
operating system is ready to go. 

1) A static IP makes everything 
easier, so switch the network settings 
for ethO: 


>> sudo nano -w /etc/network/interfaces 
Change the ethO line iface eth 


inet dhcp to the following (modify 
to meet your home network setup): 
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Iiface eth inet static 
address 192,165.1.10 
netmask 255.255.255.,0 
gateway 192.168.1.1 


2) Create a local user, and put it in 
the users and sudo group: 


>> sudo adduser YOURUSERIDHERE 
>> sudo usermod -a -G users YOURUSERIDHERE 
>> sudo usermod -a -G sudo YOURUSERIDHERE 


3) Update the system to ensure that 
it has the latest and greatest copies of 
all the libraries: 


>> sudo apt-get update; sudo apt-get upgrade 


4) At this point, you're ready to go 
headless! Shut down the PI: 


>> sudo /sbin/shutdown -h now 


Once it’s down (monitor the green 
status LEDs on the RPi circuit board 
to know when it has finished shutting 
down), unplug the monitor, keyboard, 
mouse and power cord. Attach the 
USB storage, then restart the RPI by 
plugging the power back in. 

5) Once the RPi starts up (again, 
those green LEDs are the clue to its 
state), you can ssh in to the RPi from 


any other machine on the network 
and finish all the configuration 
remotely from here on out (modify 
the following for your static IP): 


>> ssh YOURUSERIDHERE@192.168.1.10 


Congratulations, you have a 
working Raspberry Pi! 


Peripherals 
The first order of business is to get 


the external storage device mounted. 


Use dmesg to look for where the 
storage device was found—it almost 
certainly will be /dev/sda. | like using 
automounter to handle mounting 
removable storage devices, as it Is 
more flexible about handing devices 
that may not be present or ready at 
boot time: 


>> sudo apt-get install autofs 

>> sudo nano -w /etc/auto.master 

======/etc/auto.master====== 

/misc /etc/auto.misc 

======/etc/auto.master====== 

>> sudo nano -w /etc/auto.misc 
Note, my external storage device is 


formatted with ext4—modify this for 
your needs if required: 


storage -fstype=ext4 :/dev/sdal 


>> sudo /etc/init.d/autofs restart 


>> Ls -lat /misc/storage 


Optionally, create a symlink to 
shorten the path a smidgen: 


>> Ln -s /misc/storage /storage 


Backup Repository 

At the top of any home server feature 
list is providing rock-solid backups. 
With the RPi, this is pretty simple, due 
to the wide range of network-sharing 
options in Linux: Samba/CIFS for 
Windows machines, NFS for 
UNIX-based devices and even SFTP 

for more advanced backup clients like 
deja-dup. Because the RPi has only 
100Mb Ethernet, and the storage 
device is on USB, it’s not going to have 
super-fast transfer speeds. On the 
other hand, good backup clients run 
automatically and in the background, 
so it’s unlikely that you'll notice the 
slightly slower transfer speeds. 

My home network includes one 
Windows 7 machine. For it, | exported 
a backup directory on the RPi’s 
external USB storage device via Samba. 
Because the backup utility in the 
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basic version of Windows 7 doesn’t 
Support network drives as a backup 
destination, | used SyncBack Free 
(http://www. 2brightsparks.com/ 
freeware/freeware-hub.html) to 
set up automated, daily backups. 

Configuring Samba is simple. 

1) Install the samba and 
common-bin library (which has 
the smbpasswd utility): 


>> sudo apt-get install samba samba-common-bin 


2) Use smbpasswd to let your local 
ID have access: 


>> sudo smbpasswd -a YOURUSERIDHERE 


3) Edit the samba configuration file: 


>> sudo nano -w /etc/samba/smb. conf 


4) Change the workgroup = 
WORKGROUP line to match your 
Windows workgroup name. 

5) Comment out or delete the 
[homes] and [printers] share. (Printer 
sharing will be done later via direct 
CUPS access.) 

6) Add an entry for the Windows 
backup paths. Here’s my example, 
which | placed at the bottom of 
the file: 
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[win7pc] 

comment=Backup for windows PC 
path=/storage/win/pc 
writeable=Yes 

create mask=0777 

directory mask=0777 
browsable=Yes 

public=Yes 

valid users=YOURUSERIDHERE 


7) Restart Samba to implement 
your edits: 


>> sudo /etc/init.d/samba restart 


8) Test connectivity from the 
Windows machine by mapping a 
network drive from the file explorer. 

For Linux devices, deja-dup Is 
brilliantly simple to set up and use. It’s 
been installed by default on both my 
Fedora 18 and Ubuntu 12.10 installs. 
While the package name Is “deja-dup”, 
the front end is simply called 
“Backup”. Although the RPi easily 
could support NFS export, I’ve found 
that using deja-dup’s SSH option is 
easier and more portable, and it eliminates 
the need for an additional service 
on the RPi. Specifying a deja-dup 
encryption password is probably a 
good idea, unless you like the idea of 


Backup Location 
Server 

Port | 

Folder 


LWsername 


'192.168.1.10 


/storage/Linuxlaptop 


"YOURUSERIDHERE | 


Old backups will be kept until the backup location is low on space. 


Figure 2. Deja-dup Client Setup 


all your files walking off if someone 
pockets the storage drive: 


>> sudo mkdir /storage/linuxlaptop 


>> sudo chown -R YOURUSERIDHERE: YOURUSERIDHERE /storage/linuxlaptop 


From the client Linux machine, 
launch the backup utility, choose 
“SSH” as the backup location, and 


enter the RPi’s IP address and the 
storage location you just created. The 
first backup will be slow, but future 
runs will be sending only incremental 
changes, which is significantly faster. 


Multimedia Server: DLNA 
Now that everyone's files are 
backed up safely, let’s move on to 
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some fun! A DLNA server will give 
you a central place to store your 
movies, music and pictures. From 
this central repository, DLNA clients 
from every screen in the house can 
play back this content with ease. 
At least, that’s the promise. The 
reality is that the DNLA specs don’t 
quite nail down many important 
things like which formats or 
encodings are supported. Each 
client typically has a slightly 
different idea of what formats 
and server features it would like 
to support. A much higher-power 
server might be able to transcode 
local content to device-supported 
formats on the fly, but that’s not 
possible on the RPi, and the 
on-the-fly transcoding often messes 
up other features like pause, fast- 
forward and rewind. In general, 
higher-powered devices like the 
PS3, Xbox and WD TV devices can 
handle most formats without any 
transcoding. Lower-end devices like 
smart TVs or Blu-ray players support 
a much more limited list of codecs. 
For the RPi, your best bet is 
simply to encode to the standards 
your primary DLNA device supports 
and then test your other DLNA 
clients. If they won't play nicely, 
the tips in the next section may 
help. In my case, my PlayStation 
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3 acts as the DLNA client, which 
plays nicely with the compact .m4v 
files generated by Handbrake. 
Minidina is a great choice for 
the RPi DLNA server. It’s already in 
the Raspbian distribution, is quite 
simple to set up and uses minimal 
server resources while running: 


>> sudo apt-get install minidlina 
>> sudo nano -w /etc/minidlna. conf 

Here are the relevant sections of 
my /etc/minidina.conf: 


# I found keeping video + audio in different paths helpful 
media_dir=V,/storage/dina/video 


media_dir=A,/storage/dina/music 
presentation_url=http://192.168.1.10:8200/ 
friendly _name=MyRPi 


# Since I add new media infrequently, turning off 
# inotify keeps minidina for polling for 

# content changes. It's simple enough to run 

# sudo /etc/init.d/minidina force-reload 

# when new content is added. 


jnotify=no 


Once done editing, tell minidina 
to restart and rescan for content: 


>> sudo /etc/init.d/minidlna force-reload 


Minidina has the ability to provide 
movie-poster thumbnails for your 
movies for devices that support it 
(like the PS3). It makes finding a 
specific movie when scrolling through 
dozens of movie files much more 
convenient. I’ve found that the most 
compatible file layout is to have one 
directory per movie, containing just 
the movie file plus the thumbnail 
image named “Cover.jog”. Using a 
format like “MovieName.m4v” and 
“MovieName.jpg” works fine for the 
PS3, but it breaks VLC (if you can 
convince the VLC uPNP plugin to find 
the server in the first place). 

From the PS3, you can test 
connectivity by going to “Video” on 
the XMB bar. The “friendly_name” 
you set previously should be visible 
when scrolling down in the Video 
section. If you can’t find it, test to 
ensure that minidina is up by going 
to http://192.168.1.10:8200/ with 
a Web browser. 


Multimedia for Non-DLNA Devices 
Once you get DNLA working with 
some of your devices, you may find 
devices it doesn’t want to work with, 
so a multimedia plan B is a good 

idea. The nginx Web server has an 
MP4 plugin that tries to improve 
streaming over plain-old HTTP, but 
browser playback performance varied 


widely, and fast-forwarding within a 
movie didn’t work consistently either. 
It seems like the lowest common 
denominator for multimedia sharing 
across fussy or non-DLNA devices is a 
good-old-fashioned Samba share with 
guest read-only access. 

Here’s an sample section from 
/etc/samba/smb.conf: 


[dlna] 
path=/storage/dlina 
read only=yes 
browsable=yes 
public=yes 


After defining the share 
and restarting Samba (sudo 
/etc/init.d/samba restart), 
you can start to test out your clients. 
| tested the following clients 
with a mix of videos encoded with 
Handbrake as mAv files: 


m Android 4.0.4 phone: “ES File 
Explorer” with “ES Media Player” 
(player comes with install). 


m@ Android 4.1.2 tablet: “ES File 
Explorer” with “ES Media Player” 
(player comes with install). 


M Linux devices: automount 
//192.168.1.10/dina, then use 
VLC or MPlayer. 
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m@ Windows: mount //192.168.1.10:/dIna, 
then use VLC. 


All devices were able to start playing 
almost instantly and fast-forward 
with no delays. 


Print Server 

The RPi runs CUPS quite well, 
so it’s easy to share an older 
printer that doesn’t have native 
networking features. 

Install CUPS and any packages 
needed by your printer. | needed 
hplip-cups since | have an HP 
inkjet printer: 


>> sudo apt-get install cups hplip-cups 


Update the “Listen” line and add 
the Allow @LOCAL block to the 
Location directives as shown below 
(So you can use other machines on 
your LAN to administer CUPS): 


#Listen Localhost:631 
Listen 192.168.1.10:631 #Add this line 


#Comment this out 


<Location /> 
Order allow,deny 
Allow @LOCAL 


</Location> 


# Restrict access to the admin pages... 
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<Location /admin> 
Order allow,deny 
Allow @LOCAL 


</Location> 


# Restrict access to configuration files... 
<Location /admin/conf> 

AuthType Default 

Require user @SYSTEM 

Order allow,deny 

Allow @LOCAL 


</Location> 


Add your local ID to the Ipadmin 
group so you can administer CUPS: 


>> sudo usermod -a -G lpadmin YOURUSERIDHERE 


Restart CUPS: 
>> sudo /Gic/init.d/cups restart 


Then, go to http://192.168.1.10:631/ 
and click “Adding Printers and 
Classes” to set up your printer. 

My printer was auto-discovered 

on the USB, so all | had to do 

was click “share”. Also access 
https://192.168.1.10:631/admin, 
and make sure to check “Share 
printers connected to this system”. 

Once you're done, you can set 
up your clients the usual way. 

My Linux clients auto-discovered 


the printer and picked the right 
printer drivers once | entered the 
hostname. On my Windows 7 
machine, once | selected “Network 
Printer”, | had to click “The 
printer that | want isn’t listed”, 
select “Select a shared printer 

by name” and then enter the URL 
from the CUPS Web interface: 
http://192.168.1.10:631/printers/ 
HP 4500. 


Conclusion 
With a minimal amount of additional 
hardware and configuration, the 


Raspberry Pi can be a highly 
capable, compact home server. 

It can bring the wide range of 
enterprise services offered by Linux 
into a home environment with 
minimal hardware expense.m™ 


Brian Trapp serves up a spicy gumbo of Web-based yield 
reporting and analysis tools for hungry semiconductor 
engineers at one of the leading semiconductor research and 
development consortiums. His signature dish has a Java base 
with a dash of JavaScript, Perl, Bash and R, and his kitchen 
has been powered by Linux ever since 1998. He works from 
home in Buffalo, New York, which is a shame only because 
that doesn’t really fit the whole chef metaphor. 


LINUX JOURNAL 


Android dec 


Download app now in 


the Android Marketplace 


www.linuxjournal.com/android 


| Sinatra | HTMLS | Catalyst | Drupal 7 | Moodle 
| INTRO TO THE 


THE BEST WAY 
to 


Web Apps.with™™ 
Ratalyst and _ = 
7 . 
é < 
“ 
£ 


NEW COLUMN. 
THE OPEN-SOURCE 
CLASSROOM 


For more information about advertising opportunities within Linux Journal iPhone, iPad and 
Android apps, contact John Grogan at +1-713-344-1956 x2 or ads@linuxjournal.com. 


FEATURE Autoconfiguring an IPv6 Access Point with SixXS and a Raspberry Pi 


AUTOCONFIGURING AN 
IPV6 ACCESS POINT 


with SixXS 
anda 
Raspberry PI 


| use my Raspberry Pi as a low-cost 
IPv6 router and tunnel endpoint to 
provide IPv6 connectivity to my entire home 
LAN. Using SixXS as my tunnel provider, | 
configured my Raspberry Pi to be completely 
LAN-agnostic, which means | don’t have to 
worry about my ISP changing my public IPv4 
address. | even can take my Raspberry Pi 
IPv6 router to friends’ houses to make their 
networks IPv6-capable as well. 


IGOR PARTOLA 
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IPv6 is the next-generation IP protocol 
designed to deal with the address 
exhaustion we are facing with |Pv4. 
IPv6 addresses are 128 bits long, 
which is enough to address 340,282, 
366,920,938,000,000,000,000,000, 
000,000,000 individual devices. 

You can do some unique things with 
IPv6 today. Here’s a short list: 


m Access Google, Facebook and 
Wikipedia over IPv6. 


m Avoid using dynamic DNS to access 
your home/office computers when 
on the go. 


M@ Get |IPv6 certification from 
Hurricane Electric 
(http://ipv6.he.net/certification). 


m Use IPv6-capable equipment for 
anything from teleconferencing 
to sensor networks 
(https://www.sixxs.net/misc/toys). 


m Watch Star Wars in ASCII over IPv6: 
Telnet to towel.blinkenlights.nl:23 
(technically you can do this over 
IPv4 as well). 


For a more comprehensive 
list of what you can do, see 
https://www.sixxs.net/misc/coolstuff. 
There are many ways to get IPv6 


connectivity, including getting 
native support from your ISP or 
setting up a tunnel using an IPv6 
tunnel broker. Because most ISPs 
are slow to provide native IPv6 
support, let’s set up a tunnel using 
SixXS (pronounced “six access”) 
and a Raspberry Pi. SixXS is a major 
IPv6 tunnel provider that supports a 
number of tunneling protocols. 

A Raspberry Pi is a low-cost single- 
board computer that you can obtain 
for $25 or $35. It runs Linux on its 
ARM-based processor and is powerful 
enough to act as an IPv6 router 
without breaking a sweat. There are 
many uses for a Raspberry Pi—from a 
Web server to an XBMC-based media 
center or a Minecraft gaming rig. 

For the purposes of this article, | 
assume that you have a LAN with 
a single dynamic IPv4 address from 
your ISP and that you already have 
a Raspberry Pi and are running 
Raspbian, the de facto standard 
Linux distribution for it. You can 
find documentation for how to 
get started with the Raspberry Pi 
elsewhere (http://elinux.org/ 
RaspberryPiBoard). | further assume 
that your Raspberry Pi is a model B, 
which has a built-in Ethernet port. 
You certainly can use a Model A, but 
you will need to add a USB Ethernet 
or a Wi-Fi USB adapter to it first. 
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As | mentioned, SixXS supports 
a few different kinds of tunnel 
protocols, but we are interested 
only in one: Anything-In-Anything 
(AYIYA). This protocol is essentially 
IPv6 packets wrapped in IPv4/UDP 
datagrams. It has the nice property 
that it traverses most NAT setups 
without any special configuration 
required on the router. Additionally, 
when you use AYIYA with SixXS's 
autoconfiguration client (AICCU), 
you avoid using any LAN-specific 
configuration. This means once you 
have everything set up, you can 
take your Raspberry Pi IPv6 router 
anywhere. Just power it up on your 
friend's LAN, and it instantly becomes 
IPv6-connected! Let's get started. 


you can request a tunnel and a 
subnet. You will need to provide a 
reason explaining why you want to 
use IPv6 through SixXS. Provide as 
detailed a reason as you can, but it 
might just boil down to “| want to 
get my local network IPv6-enabled 
to familiarize myself with how IPv6é 
works.” Make sure to select AYIYA 
for the tunnel type. 

2) Enable IPv6 routing on your 
Raspberry Pi: 


$ echo "net.ipv6.conf.all. forwarding=1" 


msudo tee -a /etc/sysctl.conf 


$ sudo sysctl -p 


3) Once your request is approved, 
you will have addresses for a tunnel 


This means once you have everything set up, 
you can take your Raspberry Pi IPv6 router 
anywhere. Just power it up on your friend’s 

LAN, and it instantly becomes IPv6-connected! 


1) Register for an account with 
SixXS (https://www.sixxs.net/ 
signup/create). This is a multistep 
process (https://www.sixxs.net/faq/ 
account/?faq=10steps) where some 
steps will require manual approval 
from one of the SixXS members, but 
it normally goes pretty quickly. Once 
you have registered for an account, 
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and a subnet. The tunnel address is 
what your Raspberry Pi will use to 
communicate with SixXS. You will use 
the subnet to hand out addresses to 
the rest of the devices on your LAN. 
Keep the Tunnel Information page 
open while you are proceeding with 
the setup. Be patient. Typically, SixXS 
reviews tunnel requests within a few 


hours to a few days. 

4) Because every IPv6-capable 
device on your network immediately 
will receive a globally accessible IPv6 
address, you need to set up a firewall 
to protect them. Indeed, not all 
devices (such as printers) come with 
a firewall, so it is a good idea to limit 
connectivity to them from the outside 
world. This is done using a few 
ip6tables commands: 


oe 


sudo ip6tables -A INPUT -i lo -j ACCEPT 
$ sudo ip6tables -A INPUT -m conntrack 
»--ctstate RELATED,ESTABLISHED -j ACCEPT 
$ sudo ip6tables -A INPUT -p tcp -m tcp --dport 22 -j ACCEPT 
$ sudo ip6tables -A INPUT -s 2001:4830:xxxx:xxx::/64 -j ACCEPT 
$ sudo ip6tables -A INPUT -s 2001:4830:xxxx:Yxxx::/64 -j ACCEPT 


$ sudo ip6tables -A INPUT -p ipv6-icmp -j ACCEPT 


$ sudo ip6tables -A INPUT -j DROP 


read 


sudo ip6tables -A FORWARD -m conntrack 


»--ctstate RELATED,ESTABLISHED -j ACCEPT 


oe 


sudo ip6tables -A FORWARD -p tcp -m tcp --dport 22 -j ACCEPT 


read 


sudo ip6tables -A FORWARD -s 2001:4830:xxxx:Yxxx::/64 -j ACCEPT 


read 


sudo ip6tables -A FORWARD -p ipv6-icmp -j ACCEPT 


aA 


sudo ip6tables -A FORWARD -j DROP 


Note that you are letting 
two IPv6é subnets through: 
2001:4830:xxxx:xxx::/64 and 
2001:4830:xxxx:Yxxx::/64. The one 
with the Yxxx is going to be the 
routed subnet. That’s the one the rest 
of the devices on your network will 


use. The one with just the xxx will 
have only two addresses on it: ::1 
(the remote end of your tunnel) and 
::2 (your Raspberry Pi). 

5) Make sure your firewall is 
enabled at boot time, which Is easy. 
Put the following into /etc/network/ 
if-pre-up.d/ip6tables-load, and 
make it executable ($ sudo chmod 
755 /etc/network/if-pre-up.d/ 
ip6tables- load): 


#!/bin/sh 
ip6tables-restore < /etc/ip6tables.rules 


exit 0 

Now, put the following into 
/etc/network/if-post-down.d/ 
ip6tables-save, and make it executable 
($ sudo chmod 755 /etc/network/ 
if-post-down.d/ip6tables-save): 


#!/bin/sh 


ip6tables-save -c > /etc/ip6tables.rules 


if [ -f /etc/ip6étables.downrules ]; then 


ip6tables-restore < /etc/ip6tables.downrules 
exit 0 
For good measure, execute: 
$ sudo /etc/network/if-post-down.d/ip6tables-save 


6) Now that your firewall is up and 
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running, let’s bring up the IPv6 tunnel. 
All you need to do is install the 

SixXS client called from the standard 
Raspbian. The package is called aiccu. 

During the installation process, you 
will be asked a few questions, such as 
your tunnel ID (for example, T1110xx), 
your SixXS user name and password and 
so on. Note that you can set up a tunnel- 
specific password to avoid having your 
general SixXS password tn plain text on 
your Raspberry Pi. After the installation 
is complete, the configuration file will be 
generated at /etc/aiccu.conf. 

After AICCU is installed and running, 
you will have two new network 
interfaces available: sitO and sixxs. 
sitO is the IPv6-in-IPv4 tunnel, and sixxs 
is a virtual Ethernet interface that has 
the IPv6 tunnel address. You can check 
for these by running $ ip addr. 

At this point, your Raspberry Pi has 
IPv6 connectivity, which you can check 
by pinging an |IPv6-capable host: 


$ ping6 google.com 


7) The next step is to provide IPv6é 
addresses to the rest of your network 
using the routed subnet. First, edit 
your /etc/aiccu.conf and enable the 
“setupscript” option: 


-#setupscript /usr/local/etc/aiccu-subnets.sh 


t+setupscript /usr/local/etc/aiccu-subnets.sh 


82 / MAY 2013 / WWW.LINUXJOURNAL.COM 


Next, create the script at 
/usr/local/etc/aiccu-subnets.sh 
with the following content: 


#!/bin/sh 
ip addr add 2001:4830:xxxx:Yxxx::1/64 dev eth 


where 2001:4830:xxxx: Yxxx::1 Is 
your routed subnet address. Next, 
restart AICCU. Check the output 
of $ ip addr, and make sure that 
2001:4830:xxxx:YxXxx::1 is an address 
associated with your ethO interface. 
8) The last step is to install radvd, 
the router advertising daemon, and 
configure it to advertise to your LAN. 
After the installation is complete, 
make sure that /etc/radvd.conf has the 
following content: 


interface ethO { 
AdvSendAdvert on; 
MinRtrAdviInterval 3; 
MaxRtrAdviInterval 10; 


prefix 2001:4830:xxxx:Yxxx::/64 { 
AdvOnLink on; 
AdvAutonomous on; 
AdvRouterAddr on; 


AdvValidLifetime 30; 
AdvPreferredLifetime 20; 


Restart radvd, and check that IPv6 
is available on other devices on your 
network. Most modern computers will 
pick up the change immediately. 

Going forward, AICCU will detect 
any changes to your LAN automatically, 
such as an updated public IPv4 


of tunnels, such as static tunnels or 
heartbeat tunnels from SixXS. Or, you 
could take a look at tunnel providers other 
than SixXS, such as Hurricane Electric's 
Tunnel Broker (https://tunnelbroker.net) 
or Freenet6 (http://www.gogo6.com/ 
freenet6). 


Once you get this basic setup up and running, 
you can build on top of it. For example, you 
can provide your network with a local caching 
DNS server that can resolve hostnames over 
IPv6 by simply installing bind9. 


address from your ISP, and re-adjust 
the tunnel settings. Your Raspberry 

Pi is now accessible from anywhere 

in the world using its IPv6 address at 
2001:4830:xxxx:Yxxx::1. Your other 
devices will get their own public static 
IPv6 addresses. You can use an |IPv6 
connectivity test at http://test-ipv6.com 
to make sure that everything works. 

As an experiment, you can bring 
your Raspberry Pi to a friend’s house 
to see if you can make the network 
IPv6-capable there. 

Once you get this basic setup up 
and running, you can build on top of 
it. For example, you can provide your 
network with a local caching DNS 
server that can resolve hostnames over 
IPv6 by simply installing bind9. 

You also can look into other types 


You can use your Raspberry Pi as a 
Web server, serving content over IPv6. 
Apache2 and nginx both support IPv6é 
out of the box, and many guides are 
available for turning your Raspberry Pi 
into a Web server. 

Another thing to try is setting up 
VoIPv6 on your Raspberry Pi with VOVIDA 
(http://www.linuxjournal.com/ 
article/7047). 

In conclusion, using IPv6 opens 
up a world of new possibilities and 
lets you do things you could not do 
before. Give it a try and have fun.m 


Igor Partola is an independent software developer specializing 
in scalable, distributed Internet applications. He has a particular 
interest in free and open-source software, as well as networking. 
He often is described by his friends as an “IPvé nut”, because 
he is constantly advocating that people get IPvé access. 
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ROCK YOUR STAGE LIGHTING WITH 
A RASPBERRY PI LIGHT CONTROLLER. 


JONATHAN BROGDON 
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am the proud parent of twin 
I 13-year-old rock-star daughters. 

They are seriously good musicians, 
and of course, | taught them everything 
they know. The girls typically perform 
indoors “coffee-house” style or 
outdoors in the daylight. But this fall, 
the girls booked a number of outdoor 
gigs in the evening. This meant we 
had to have stage lighting. After a 
quick trip to the local music instrument 
supercenter—where they know us by 
name—we had all the lights, stands 
and trusses we needed for a good 
night-time show. The light system 
we purchased had many useful built-in 
options for creating light shows: 
various color chase sequences, variable 
strobe speeds and sound-activated 
or fixed-time sequencing. These are 
great options. But, if you are looking 
for maximum wow-factor from a 
performance, you want to have direct 
control over the light system. 

Lighting control hardware Is 
available to control your stage 
lighting. In addition, several 
commercial and open-source software 
lighting control packages work with 
many off-the-shelf lighting devices. 
Some of these, such as QLC and 
QLC+, are available for Linux. Many of 
the software light controller packages 
are based on the Open Lighting 


Architecture (http://www.opendmx.net/ 
index.php/OLA). If you are looking 
to set up a professional light show 
and need to control several complex 
devices, such as movable lights, one 
of these options is probably the way 
to go: 
| am the sound guy/roadie/driver/ 
financier for this band. So | figured, 
what could it hurt to add lighting 
control guy to my résumé? Given 
my other duties during the show, 
| wanted something pretty simple 
to operate, with capability to 
add custom features as needed. 
Commercial lighting control 
hardware seemed like overkill for 
my needs, and | wasn’t real keen on 
dragging a laptop to a show just to 
control the lighting. This sounded 
like a good Raspberry Pi project. 
When | started investigating lighting 
control options, | quickly found the 
language of light control: DMX512. 
The United States Institute for Theatre 
Technology created DMX512 in 1986 
as a Standard to control dimmers on 
stage lights. The standard has had a 
few updates since 1986 and is now an 
ANSI standard. DMX512 uses a multi- 
drop RS-485 bus for the physical layer 
signaling. There is a single master 
device (the controller) and up to 512 
Slave devices (the lights). The RS-485 
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Figure 1. Raspberry Pi DMX512 Light Controller (photo by Jonathan Brogdon) 
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differential signaling provides for 
good noise immunity over the long 
cable runs needed to control lights 
that are spread around a stage or 
arena. Each slave DMX512 device 
has IN and OUT XLR connections, 
and devices are daisy-chained 
together. The last device in the 
chain should include an XLR 
stub connector with a 120-Ohm 
termination resistor. For the girls’ 
stage lighting, we used two Chauvet 
COLORstrip Mini LED wash lights. 
The DMX512 protocol is very basic. 
Remember, it originally was designed 
for light dimmers. The only protocol 
message, sent by the master, is a 
block of unsigned byte values 
(O-—255)—one for each “channel”. 
Each slave device has its own 
definition of how a “channel” is 
interpreted. For example, channel 
one may set the general light mode 
(fixed color, fixed sequence, random 
sequence and so on). The second 
channel may indicate the sequence 
transition speed (fixed value, sound 
activated and so on). On the other 
hand, a very simple device might 
define the channel values as dimmer 
values for each light on the device. 
The manufacturer's documentation 
will spell out how each channel should 
be used. The DMX512 protocol runs 


at a fixed 250k baud rate. 

One interesting quirk of the 
protocol is that messages must be 
sent continuously. If the master stops 
sending messages to a device, the 
lights go out. This also means that 
once a device receives a message 
with channel values specifying a 
particular light sequence, it will run 
the sequence as long as It keeps 
receiving messages with the same 
channel values. For example, suppose 
the value for channel 1 is 80, which 
indicates that the color sequence Is 
red, green, blue, yellow, magenta, 
cyan, white. The value for channel 2 
is 10, which indicates that the color 
should change every ten seconds. 

If you want to keep this sequence 
running, the master must keep 
sending messages with channel 1=80 
and channel 2=10. 

| found a simple USB-RS-485 converter 
based on the ubiquitous FT232R USB- 
Serial chip from Future Technologies 
Devices International. You can find these 
for around $20 or less from several 
sources. | got mine on eBay. | attached 
a three-pin female XLR connector to 
the RS-485 I/O pins, and voila, | had my 
DMX512 physical interface. The Entec 
Open DMX USB is another popular 
option (http://www.enttec.com/ 
open_dmx_usb). This product also is 
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based on the FT232R chip and comes 
in a nice sturdy steel enclosure, all for 
$70. The code in this article works with 
either option. Note that the Open DMX 
USB box has a five-pin XLR connector. 
If you plan on using the less-expensive 
three-conductor DMX512 cables, you 
will need to add an XLR five-pin-to- 
three-pin adapter. 

Now, | needed a software interface 
for sending DMX512 protocol 
messages. The main task here is 
configuring the FT232R chip for 
DXM512 communication at 250 kBaud 
with eight data bits, no parity and two 
stop bits. Most Linux distributions have 
a driver that supports the FT232 family 
of devices. However, if you are thinking 
about using the serial device interface 
presented by the driver (for example, 
/dev/ttyUSBO), you probably won't get 
far. Standard utilities like stty will not 
Support setting the 250-kBaud rate. 
Instead, you need to talk to the FT232R 
as the USB device that it is. 

My language of choice for this 
project was Python. So, | looked 
around for Python packages that 
could address the FT232R chip 
as a USB device. | found PyFtdi 
(https://github.com/eblot/pyftdi.git). 
PyFtdi provides a user-space driver 
for talking to FTDI devices. The 
PyFtdi package depends on PyUSB 
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(https://github.com/walac/pyusb.git), 
which depends on LibUSB 
(http://www.libusb.org). | used the 
standard Raspian “Wheezy” image for 
this project. So, | was able to install 
libusb via the package manager. | 
installed PyUSB and PyFtdi via the setup 
scripts included with each package. The 
source for the DMX512/USB interface is 
shown in Listing 1. Note that a DMX512 
protocol message must be terminated 
with two break characters. 

The DMX512 controller needed a 
user interface. My first thought was 
for a grand Web interface over an ad 
hoc Wi-Fi network. The plan was to run 
the Ul from a browser on my phone 
or tablet. But, that would mean more 
gear to be charged up and dragged to 
the show. Plus, I’ve learned (the hard 
way) to pick reasonably economical 
solutions for band support gear so | 
can afford a backup. | decided to use a 
much simpler UI device: the Adafruit Pi 
Plate LCD+Keypad. This is a two-line x 
16-character LCD with five key buttons: 
“up”, “down”, “left”, “right” and 
“enter”. This device is made specifically 
for use with the Raspberry Pi, and it 
plugs in directly to the GPIO header. 
The Pi Plate uses the Hitachi HD44780 
LCD controller. The LCD interface and 
key buttons are accessed via an i2c I/O 
expander on the Pi Plate. 


Listing 1. DMX512/USB Interface Module 


from pyftdi.pyftdi import ftdi 


#FTDI device info 
vendor=0x0403 
product=0x6001 


HIRE HAHA 
# DMX USB controller 
THREE HAE 
class OpenDmxUsb(): 

OF ilie (Seine 
self.baud_ rate = 250000 
self.data_bits = 8 

self.stop_ bits = 2 
self.flow_ctrl = '' 


Sel istSmstacer— 0) 


f 
f 
f 

self.parity = 'N' 
if 
if 
if 


self._init_dmx() 


#Initialize the controller 

det saiiniitudnxiCselsh) i 
self. ftdi=ftdi.Ftdi() 
self.ftdi.open(vendor, product ,0) 
self.ftdi.set_baudrate(self.baud_rate) 
self.ftdi.set_line_property(self.data bits, 


Adafruit provides some example 
Python code for the Pi Plate 
(https://github.com/adafruit/ 
Adafruit-Raspberry-Pi-Python- 
Code.git), demonstrating how to 
write to the LCD and read from the 
key buttons. This code is great for 
a single application that controls 
all the LCD resources. | needed the 
UI to run automatically when the 
system boots. | could have adapted 
the Adafruit Pi Plate example code 
to run as a demon. However, | 


Self, Stoph bits, 
Sel  pakeltyi, 
break_=0) 
self.ftdi.set_flowctrl(self.flow_ctrl) 
Seah Cin pune CulexXan DUI hern() 
Sei edi pine CmtXabUiinern@) 
Sel ciel! .S@u_reS(Seli fr eS_Suealee)) 


#Send DMX data 
def send_dmx(self,channelVals) : 
self.ftdi.write_data(channelVals) 
# Need to generate two bits for break 
Selim edinsete Lineapropenuy (Seliiadatasbiltse 
self.stop_ bits, 
Selliiipalaleyis 
break_=1) 
self, ftdi, set. Line property (self, datalbits:, 
self.stop_ bits, 
self.parity, 
break_=1) 
Seiliat tdi Sum LiInempropenty(Seltadatasbits. 
Sei sitOpabicese 
Sel apatmieyis 
break_=0) 


considered LCDproc to be a better 
choice (http://Icdproc.org). LCDproc 
is the de facto UI framework for 
embedded Linux systems that support 
LCDs—with or without keys. 

The LCDproc framework is 
composed of a server demon with 
“drivers” for specific LCD families 
and physical connection options (that 
is, parallel, serial and so on). Note 
that these are userspace drivers that 
use device interfaces to access the 
LCD hardware. An LCDproc client 
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application contacts the server over 

a socket to output to the LCD or 
read key input. A client can allocate 
an area of the LCD for its output or 
map individual keys for its input. For 
example, you might have a client 
that displays the system uptime on 
the left side of the first line, another 
client that displays the current system 
time on the right side of the first 
line, and a third client that displays 
the IP address on the second line. | 
liked the flexibility of having multiple 
LCD clients for future applications. 
The LCDproc communication protocol 
uses text strings over a TCP socket 
connection. This makes for easy 
protocol debugging. 

LCDproc provides a driver for 
the HD44780 LCD, with several 
connection options. Unfortunately, 
LCDproc did not have driver support 
for the Pi Plate’s LCD connection via 
the i2c I/O expander. So, | decided 
to add it. See https://github.com/ 
jlbrogdon/Icdproc-piplate.git for 
the Pi Plate driver patch. 

LCDd is the LCDproc server 
dzmon. The LCDd configuration file 
contains several server and driver 
options. By default, the path to 
this file is /etc/LCDd.conf. For the 
Pi Plate LCD, the following config 
options should be used: 
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[server] 


# Where can we find the driver modules? 


# IMPORTANT: Make sure to change this setting to reflect your 


# specific setup! Otherwise LCDd won't be able to find 
# the driver modules and will thus not be able to 
# function properly. 


# NOTE: Always place a slash as the last character! 


DriverPath=/usr/local/lib/1lcdproc/ 


Driver=hd44780 


[menu] 
# You can configure what keys the menu should use. 
# Note that the MenuKey will be reserved exclusively; 


# the others work in shared mode. 


# Up to six keys are supported. The MenuKey (to enter 
# and exit the menu), the EnterKey (to select values) 
# and at least one movement key are required. 

# These are the default key assignments: 
#MenuKey=Escape 

EnterKey=Enter 

UpKey=Up 

DownKey=Down 

LeftKey=Left 


RightKey=Right 


## Hitachi HD44780 driver ## 


[hd44780] 


# Select what type of connection. 
# See documentation for types. 


ConnectionType=i2c-piplate 


# i2c address for the I/O expander 


Port=0x20 


# Device of the serial interface [default: /dev/1cd] 


Device=/dev/i2c-1 


# Bitrate of the serial port (0 for interface default) 


Speed=0 


# If you have a keypad connected. 
# You may also need to configure the keypad layout 
# further on in this file. 


Keypad=yes 


# If you have a switchable backlight. 


Backlight=yes 


# Specifies the size of the LCD. 
# In case of multiple combined displays, this should 


# be the total size. 


—— , 
> asad 4 ys 
ae Se 


Tey wr. ——— 


S$ize=16x2 


KeyDirect_1=Enter 
KeyDirect_2=Up 
KeyDirect_3=Down 


KeyDirect_4=Left 


KeyDirect_5=Right 


A complete config file is available 
with the patch. 

With the LCDproc server up and 
running, | could focus on the LCD 
client side of my light controller. | 
used the Python Icdproc package 
(https://github.com/jingleman/ 
Icdproc.git) for the client interface to 
LCDproc. This allowed the DMX512 
light controller client to open a 
connection to the LCDproc server, set 
up widgets on the LCD, send output 
to the widgets and get input from 


_ -- fe 


&° @ SELECT 
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Figure 2. Pi Plate LCD Keys (photo by Jonathan Brogdon) 
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Listing 2. Light Controller UI Processing Module 


from lcdproc.server import Server # Get a key from LCDproc 


defi getakey (self): 


Seidel bd lll dt ee resp = self.lcd.poll() 
# LCD UI controller for the DMX controller if (resp == None): 
HHA AH Ed eee return None 


class DmxUi(): 


def Sainte (seit icolonzlist)< return resp[4:-1] 
self.color_list=color_list 
self.lcd = Server("127.0.0.1", debug=False) # UI processing 
self.lcd.start_session() # -get keyinput 
self.lcd.add_key("Up" ,mode="excLusively") # -update display 
self.lcd.add_key("Down" ,mode="exclusively") # -return the current selection 
self. lcd.add_key("Enter" ,mode="exclusively") def ui_process(self): 
#Allocate the screen key_press = self.get_key() 
self.screen = self.lcd.add_screen("DMX") 
self.screen.set_heartbeat ("off") if (key_press==None) : 
return None 
#Add a widget for the Label 
self.label_widget = if (key_press == "Up"): 
self.screen.add_string_widget("Label_widget", self.color_idx -= 1 
text="",x=1, y=1) 
#Add a widget for the color if (key_press == "Down"): 
self.color_widget = self.color_idx += 1 
self.screen.add_string_widget("color_widget", 
text="",x=7,y=1) self.color_idx %= self.num_colors 
#Add a widget to display the "selected" status 
self .not_set_widget = if (key_press == "Enter"): 
wself.screen.add_string widget ("not_set_widget", self.current_color_idx = self.color_idx 
text="",x=16, y=1) 
#Set the label text if (self.color_idx != self.current_color_idx): 
self. label_widget.set_text("Color:") self .not_set_widget.set_text("*") 
elise: 
self .color_idx=0 self .not_set_widget.set_text("") 
self.current_color_idx=0 
self.color_widget.set_text(self.color_list[self.color_idx] [0]) self.color_widget.set_text(self.color_list[self.color_idx] [0]) 
self.num_colors = len(self.color_list) 
return self.current_color_idx 
the key buttons. For this project, | the “select” key to select the desired 
used the “up” and “down” keys to color output (Figure 2). 
cycle through light color options and Listing 2 shows the UI processing for 
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Figure 3. Collage of Color Selections (photo by Jonathan Brogdon) 


the light controller. This code opens 
the LCDproc server connection, defines 
the Ul widgets for the LCD, displays 
the light color options, processes the 
key button input and updates the UI 
widgets based on key inputs. 

The light controller application ts 
packaged as a Python script with a 
Start-stop-daemon script to run the 
application at system initialization. The 
Python script is shown in Listing 3 and 
is available at https://github.com/ 
jlbrogdon/dmx_controller. 


The application has two concurrent 
threads: the UI thread and DMX512 
controller thread. The UI thread runs 
the LCDproc client shown in Listing 2. 
When a new light color is selected, the 
Ul thread builds a complete DMX512 
protocol message, with channel values 
corresponding to the user-selected light 
color and queues the message to the 
DMX512 controller thread. 

The DMX512 controller thread 
initializes the FT232R device for 
DMX512 communication and 
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Listing 3. Light Controller Application Module 


from DmxUi import DmxUi 

from OpenDmxUsb import OpenDmxUsb 
import Queue 

import threading 

import signal 


# Thread lock serves as a signal to thread to terminate 


termLock = threading.Lock() 


# Tuple List of colors and corresponding 
# Colorstrip channel value 


static_color = [('RED' PLO)S 
('GREEN' ,20), 
(BLUE* 730), 


('YELLOW' ,40), 
('MAGENTA' ,50), 
('CYAN' , 60), 
('WHITE' ,70)] 


#Asynchronous signal handler. Terminates threads. 
def sig_handler(signum, frame) : 
termLock.acquire() 


Herel ee 

# DMX Control thread 

dertie e 

class DmxThread(threading. Thread) : 

def __ init__(self ,dmxUsb, queue, tlLock=None) : 

threading. Thread.__init__(self) 
self.dmxUsb = dmxUsb #DMX/USB controller 
self.queue = queue #DMX data queue 


self.tlock = tlock #thread termination lock 


def run(self): 
channelVals = None 
while (False==self.tlock.locked()): 
#Check for new DMX data 
if (self.queue.empty() == False): 
#New values available 
channelVals = self.queue.get() 
self.queue.task_done() 
if channelVals != None: 
#Send the data to the devices 


self.dmxUsb.send_dmx(channelVals) 


Hide al he 

# LCD UI thread 
Hd ah 

class UiThread(threading. Thread) : 


def __init__(self,dmx_ui,color_list, queue, tlock=None) : 


threading. Thread.__init__(self) 

#DMX UI device 
self.color_list = color_list #Color list 
#DMX data queue 


self.dmx_ui = dmx_ui 


self.queue = queue 
self.tlock = tlock 


def run(self): 
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if 


# 
s 


channel_vals = bytearray([0]*513) 
channel_vals[0]=0 #dummy channel 


#Set Initial value 
channel_vals[1]=self.color_list[®] [1] 


#Send the DMX data 
self.queue.put(channel_vals) 


while (False==self.tlock. lLocked()): 

#Check for UI input 

color_idx=self .dmx_ui.ui_process() 

if (color_idx != None): 
#New color value input 
channel_vals[1]=self.color_list[color_idx] [1] 
#Send the new DMX data 
self.queue.put(channel_vals) 


name__ == "__main__": 


Install signal handler for SIGTERM 
ignal.signal(signal.SIGTERM,sig handler) 


#Queue for new DMX data 


iG 


Bs 


533 


# 


hannelsQueue=Queue . Queue () 


DMX/USB controller 


dmx_usb = OpenDmxUsb() 


UI controller 


dmx_ui = DmxUi(static_color) 


DMX/USB controller thread 


dmx_thread = DmxThread(dmx_usb, 


channelsQueue, 
tlock=termLock) 


#UI controller thread 


u 


# 


ji_thread = UiThread(dmx_ui, 
static_color, 
channelsQueue, 
tlock=termLock) 


Start the DMX/USB controller thread 


dmx_thread.setDaemon(True) 
dmx_thread.start() 


# 
u 
u 


Start the UI controller thread 
i_thread.setDaemon (True) 
i_thread.start() 


#Wait for SIGTERM 


Ss 


ignal.pause() 


#Wait for threads to terminate 


dmx_thread.join() 


u 


i_thread.join() 
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continuously checks for any new 
protocol messages from the UI thread. 
Any new protocol message received 
from the UI thread is sent repeatedly 
to the DMX512 slave devices. Recall 
that when the controller stops sending 
protocol messages, the slave turns off 
the lights. Figure 3 shows a collage of 
the various output colors. 

Many of the DMX512 light control 
systems available today provide a lot 
of configurable options for the user, 
which also adds a learning curve and 
potentially many more levers for you to 
pull during the stage show. However, if 
you are looking for something simple 


to control a few stage lights for your 
band, small stage production or holiday 
lighting display, this Raspberry Pi-based 
light controller has the benefits of 
simplicity, extensibility, customization 
and low cost. One of my ultimate goals 
is to add a song selection menu and 
have the controller sequence the lights 
according to values in a corresponding 
file. Until then, rock on!m 


Jonathan Brogdon is a software team manager at Ixia, working 
on timing and synchronization products. He lives in Austin, Texas, 
with his wife and three rock-star kids. His interests include 
embedded Linux, M2M software, the Internet of Things and 
just about any development board he can get his hands on. 
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Effects of Cloud 
Computing on 


Open-Source 
Compliance 


What you should know if you are deploying open source in the 


cloud. DIANA MARINA COOPER 


Since the emergence of 

strong cloud service providers like 
Amazon Web Services, Google and 
Rackspace, software development 
and deployment Is increasingly taking 
place in the cloud. According to 
Gartner, cloud computing Is expected 
to grow at a rate of 19% this year. 
Big industry players including Netflix 
and eBay already have turned to the 
cloud for significant proportions of 
their operations and offerings. And 
in the next few years, we are likely 
to see more and more innovative 
startups like Coupa completely 
suspended in the cloud, relegating 
on-premise computing to a vestige of 
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a bygone era. 

While enterprises are shifting 
from legacy solutions toward the 
cloud, open-source software is 
gaining significant traction for 
similar reasons. Gartner projects that 
99% of Global 2000 companies will 
incorporate open source into their 
operations by 2016. Adopters of both 
cloud and open-source solutions are 
drawn toward the increased potential 
for collaboration and lower total cost 
of ownership. 

The proliferation of open-source 
cloud projects (think OpenStack, 
CloudStack, Eucalyptus) and 
increasing use of open-source 


software within the cloud suggests 

a need for enterprises to understand 
how the cloud environment 

impacts open-source license 
compliance. Before the emergence 
of the cloud, restrictive open- 
source licenses maintained software 
freedom through the regulation 

of distribution. However, because 
software is provided as a service in 
the cloud, licensing obligations that 
are linked to the act of distribution 
no longer apply. This has led to the 
development of newer cloud-driven 
restrictive open-source licenses, such 
as the AGPL. The game-changing 
effect of the cloud on traditional 
open-source compliance mechanisms 
and the subsequent development of 
remedial open-source licenses calls 
for organizations to audit and update 
their intellectual property policies to 
minimize the risk of infringement. 


The Traditional Proprietary vs. 
Open-Source Battle and the 

Rise of Permissive and Restrictive 
Licenses 

The emergence of cloud computing 
and its impact on open-source 
compliance has reignited the 
historical battle between proprietary 
and open-source software, and 
reinforced traditional divisions 
within the Open Source community. 


The genesis of the proprietary vs. 
open-source debate dates back 
to the unbundling of IBM in the 
mid-1970s, after which it was no 
longer possible for users to access 
and modify code. Although user 
freedoms were removed through the 
process of unbundling, programmers 
continued to find ways to access, 
modify and share code, famously 
prompting Bill Gates to write his 
“Open Letter to Hobbyists” after 
Microsoft's Basic was leaked. 
During the late 1970s and early 
1980s, the Open Source movement 
emerged in two distinct factions, the 
first of which was headed by Richard 
Stallman, a former programmer at 
the MIT Artificial Intelligence Lab. 
Stallman’s belief that the ability to 
access, modify and redistribute code 
is a fundamental freedom led to his 
development of the GNU project, 
which was licensed under the GPL—a 
restrictive license specifically designed 
to ensure that GNU code could 
not be rendered proprietary when 
incorporated in derivative works. 
Around the same time, the BSD 
UNIX system was being developed 
by the Computer Science Research 
Group at Berkeley. In the late 
1990s, the BSD UNIX became 
available under the BSD license. 
While Stallman’s GPL was designed 
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as a restrictive copyleft license 
aimed at preventing the underlying 
code from becoming proprietary, 
the BSD was drafted as a permissive 
license that would enable users to 
embed the underlying code into 
proprietary offerings. 


Permissive vs. Restrictive 
Open-Source Licenses in the 
Pre-Cloud Environment 
Licenses that cover open-source 
code carry unique terms that have 


implications on code use, modification 


and distribution. As previously 
mentioned, there are two broad 
categories of open-source licenses— 
the permissive and restrictive types. 
Permissive licenses, such as the MIT 
and BSD licenses, provide minimal 
obligations on code use, modification 
and distribution, enabling developers 
to incorporate open-source code into 
proprietary software, which they then 
could protect by adding additional 
license terms. 

In contrast, restrictive open- 
source licenses, such as the GPL, 
do not allow users of covered code 
to release derivative works under 
different license terms. In addition, 
these restrictive licenses require 
users that distribute modified 
programs to make their source code 
available to downstream users, 
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in order to maintain the copyleft 
community's goal of achieving 
software freedom. This concept 

of software freedom refers to the 
right of all downstream users to 
access, run, modify and redistribute 
software containing the covered 
code. This feature of restrictive 
licenses renders it impossible to 
incorporate open-source code into 
proprietary offerings. There is no 
way to avoid these stringent rules, 
and the failure to comply with 
such obligations can lead to severe 
consequences, including being 
forced to come into compliance by 
releasing the asset's source code 
or paying damages for intellectual 
property infringement. 

In the pre-cloud environment, 
software vendors made their 
products available to end users 
through software distribution. 
Because there was no other means 
of making software available to 
users, it was impossible for vendors 
to escape the distribution clauses 
in restrictive open-source licenses. 
However, this has changed with the 
introduction of cloud computing. 


Cloud Computing’s Challenge to 
the Distribution-Based GPL Model 
Restrictive open-source licenses, 

such as the GPL, operate to maintain 


However, because software is not distributed in 
the cloud—it’s simply made available to users 
as a service—providers do not have to pay these 


freedoms forward. 


software freedom only to the extent 
that the underlying open-source code 
is part of a distribution. For example, 
the GPLv3 states that: 


You have certain responsibilities 
if you distribute copies of the 
software: responsibilities to 
respect the freedom of others. 

If you distribute copies of such 

a program, whether gratis or for 
a fee, you must pass on to the 
recipients the same freedoms that 
you received. You must make sure 
that they, too, receive or can get 
the source code. 


Before the emergence of the 
cloud, this license term ensured that 
any time software incorporating 
covered code was deployed to third 
parties, that distribution would be 
governed by the GPL terms such 
that the distributor would be forced 
to make its code available to users. 
However, the proliferation of cloud- 
based SaaS solutions threatened to 
destabilize the GPL model by creating 


an environment in which for the first 
time software was made available to 
users without being distributed. 


GPL: Permissive within the Cloud 
In instances where software 
containing GPL code is made 
available through network services, 
the distribution clause is bypassed, 
and the provider does not have to 
release its source code. Remember 
the free software reciprocity trigger: 
“If you distribute copies of such a 
program...you must pass on to the 
recipients the same freedoms that 
you received.” However, because 
software is not distributed in the 
cloud—it’s simply made available to 
users aS a service—providers do not 
have to pay these freedoms forward. 
Rather, they can access the benefits 
of using free software without 
being forced to provide those 

same benefits to their users. This 
loophole enables SaaS enterprises 
to embed GPL-covered code 

into proprietary cloud offerings. 
Effectively what this means is that, 
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within this distribution-free model, 
the GPL assumes the attributes of a 
permissive license (think MIT, BSD). 


AGPL: the Open-Source Empire 
Strikes Back 

For anyone who thought that the 
cloud rendered the proprietary 
and open-source debate moot, 
think again—the battle is far 
from over, it simply relocated to 
another frontier. Before long, 

the copyleft faction of the Open 
Source movement regrouped and 
responded to the threat that the 
cloud-based SaaS model posed to 
its goal of maintaining software 
freedom. The weapon of choice 
that the movement developed 
and deployed to respond to the 
unique challenges imposed by 
the emerging cloud-based SaaS 
environment was the Affero GPLv3 
(AGPLv3), which covers popular 
applications, such as PHP-Fusion, 
Launchpad and SugarCRM. 

Unlike the GPL, which relies on 
the act of distribution to trigger the 
free software reciprocity clause, the 
AGPLv3 includes the following term 
that was articulated specifically for 
situations in which software is used 
on a network but is not technically 
distributed. This clause states that: 
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If you modify the program, 

your modified version must 
prominently offer all users 
interacting with it remotely 
through a computer network 

(if your version supports such 
interaction) an opportunity to 
receive the corresponding source 
of your version by providing 
access to the corresponding 
source from a network server 

at no charge, through some 
standard or customary means of 
facilitating copying of software. 


This license term applies the 
distribution-based reciprocity clause 
to cloud-based software offerings 
in which users run programs from 
remote servers. 


AGPL in the Private Cloud 

The AGPL was drafted as a solution 
to the problem that the public 
cloud created. Its preamble states 
that whereas the GPL “permits 
making a modified version and 
letting the public access it ona 
server without ever releasing its 
source code to the public...the AGPL 
is designed specifically to ensure 
that, in such cases, the modified 
source code becomes available to 
the community.” But what happens 
if an organization uses AGPL code 


internally? The remote network 
interaction clause states that: 


If you modify the program, 

your modified version must 
prominently offer all users 
interacting with it remotely 
through a computer network 

an opportunity to receive the 
corresponding source of your 
version...through some standard 
customary means of facilitating 
copying of software. 


It appears that the same principle 
applies in both the public and 
private cloud contexts—any 
users have the right to access 
the modified code and to create 
their own versions. In the private 
cloud scenario, these freedoms 
would extend to any employees, 
contractors and other parties using 
the server. 


Consequences of Non-Compli- 
ance with Open-Source License 
Obligations 

The failure to comply with open- 
source license obligations can 

lead to severe consequences, 
including being forced to come 
into compliance by releasing the 


modified code and paying damages. 


Non-compliant organizations are 
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exposed to risk, as courts In various 
jurisdictions including the United 
States, Germany and France have 
consistently ruled that open-source 
licenses are enforceable, leading 

to a proliferation of open-source 
litigation and settlements. 

One of the earlier infringement 
suits that solidified the enforceability 
of open-source software resulted 
from the acquisition of Linksys by 
Cisco in 2003. Shortly after the 
acquisition, Cisco was sued for 
infringement relating to the use 
of GPL-covered code in its router 
firmware. It turned out that the 
infringing chipset was provided 
to Linksys by Broadcom, which in 
turn outsourced the development 
to a third party. As a part of the 
settlement that was reached 
between the parties, Cisco was 
forced to make the infringing code 
available on its Web site, appoint an 
open-source compliance officer and 
make a monetary contribution to the 
Free Software Foundation. 

BusyBox also launched a string of 
successful infringement suits against 
companies that incorporated its 
code and leveraged the resulting 
assets in violation of the GPL. The 
first of these involved the use of 
BusyBox code in embedded systems 
provided by Monsoon Multimedia, 
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Inc. BusyBox alleged that Monsoon 
utilized BusyBox code without 
making its modified code available 
to downstream users pursuant to 
the GPL. The parties settled for an 
undisclosed amount, and Monsoon 
agreed to publish its code and 
appoint an open-source compliance 
officer. A similar settlement was 
reached between BusyBox and 
Verizon Communications. More 
recently, BusyBox filed a suit against 
14 electronics suppliers, including 
Samsung and Best Buy, alleging 
that the defendants distributed 
devices containing BusyBox code 
without making their modified code 
available to users. While some of 
these defendants opted to settle, in 
the case of Westinghouse, a District 
Court in New York found in favor 
of the plaintiff. In that case, the 
Court determined that Westinghouse 
willfully infringed BusyBox’s copyright 
in the code, and consequently the 
damages were tripled. 

The proliferation of open-source 
infringement suits and resulting 
settlements have solidified the 
enforceability of open-source 
software. Because of the immense 
financial and reputational damage 
that is associated with intellectual 
property infringement suits, it is 
crucial for organizations to ensure 
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compliance with open-source license 
obligations. Although the cloud 
environment poses new uncertainties 
for organizations relying on open- 
source software, there are various 
tools that can be engaged to 
minimize the risk of non-compliance. 


How to Transition Your Organization 
into the Cloud 

Given the new obligations imposed 
by the AGPLv3, it is critical for 
cloud-based SaaS providers to 

take inventory of the open-source 
code embedded in their product 
offerings and to ensure that their 
intellectual property policies are in 
line with the obligations imposed 
by the various open-source licenses 
covering the code being used. A 
variety of tools are available that 
can assist SaaS enterprises to ensure 
open-source compliance in the 
cloud. For example, enterprises can 
scan their software with tools that 
are specifically designed to detect 
open-source code and provide 

a list of the license obligations 

that accompany each component. 
In addition, a structured Open 
Source Software Adoption Process 
(OSSAP) can be used to define 
acceptable intellectual property 
license policies for the organization, 
audit the current software 


portfolio and incoming code, and 
ensure compliance through all of 
the software development and 
procurement stages. 

Open-source license management 
solutions now are accessible to 
companies in the cloud. Because 
these solutions are hosted in the 
cloud environment, they eliminate 
the need for enterprises to install 
or update code-scanning software. 
Instead, companies can sign up 
with a service provider and are 
given access to software that scans 
their code, identifies open source 
and provides a breakdown of the 
associated license obligations. Such 
open-source license management 
services are invaluable to SaaS 
enterprises, particularly given the 
uncertainties associated with open 
source in the cloud. In addition 
to ensuring that organizations 
understand and are able to 
meet their open-source license 
obligations, these management 
solutions position enterprises to 
respond efficiently and effectively 
to any instances of non-compliance 
that are detected. For example, by 
understanding which components 
of the software are used in a non- 
compliant fashion, SaaS enterprises 
are positioned to replace the 
infringing code with code that 


offers similar functionality or to 
adapt their policies to ensure 
adherence to obligations. 


Conclusion 

The emerging cloud-based SaaS model 
offers immense opportunities but 
also raises new risks for organizations 
in relation to intellectual property 
infringement. Various open-source 
license management solutions are 
available to assist enterprises in 
making a safe transition into the 
cloud. For enterprises planning on 
navigating the cloud environment— 
and for those that already have 
made the migration—it is important 
to take an inventory of the code 
incorporated in the software being 
offered and to determine if open- 
source licensing obligations are 
being met. Keep in mind that the 
intellectual property policies that 
were developed for the traditional 
software distribution model will need 
to be assessed and updated to meet 
the distinct obligations associated 
with the cloud environment.m 


Diana Marina Cooper obtained a BA in Politics and Governance 
and an MA in Globalization Studies. She is currently a JD Candidate 
(2013) and is pursuing a concentration in Law and Technology. 
She has been working with Protecode (http://www.protecode.com) 
as an open-source corporate strategy consultant since 2011. 
Follow Diana: @Diana_M_Cooper. 
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The upper hands of big-tech business are changing their game. 


dobe Systems, the world’s 
leading supplier of graphical 
software, is gradually shifting 


its business to a subscription model, 
baiting customers with features and 
tools available only to Creative Cloud 
subscribers (http://html.adobe.com/ 
edge/creativecloud). Among the 
first of these is Edge Reflow 
(http://html.adobe.com/edge/ 
reflow), which Adobe expects 

to become a must-have for Web 
designers—just as Photoshop, 
Illustrator and other tools in Adobe's 
Creative Suite are long-standing must- 
haves for many photographers and 
graphic designers. The difference is 
that you own Creative Suite when you 
buy it. You only rent Creative Cloud 
when you subscribe to it. 

Microsoft has been doing the 
same thing with Office 365 
(http://office.microsoft.com/en-us). 
Originally built for enterprise 
customers, Office 365 now is 
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available for “home” customers 

as well. “Your complete Office 

in the cloud”, will work on “up 

to 5 PCs or Macs”, and is priced 

at $99.99/year or $9.99/month. 
That’s competitive with the price of 
Microsoft's boxed Office software, 
which becomes stale as soon as 
the next major version comes out. 
And, like Adobe's Creative Cloud, 
Office 365 baits customers with 
lots of features lacking in the old- 
fashioned sold versions of the suite. 

What both want you to rent Is SaaS: 
Software as a Service. 

The tide of history is with them. 
Nicholas G. Carr's The Big Switch 
(http://www. nicholasgcarr.com/ 
bigswitch) accurately predicted a 
shift to “computing as a utility” back 
in 2004, long before utility services 
became known as “the cloud”. This 
always has made sense for enterprises, 
which can save IT costs by renting 
software as well as compute and 


The difference is that you own Creative Suite 
when you buy it. You only rent Creative Cloud 
when you subscribe to it. 


data storage services. We also have a 
model for SaaS at the individual level, 
in the form of smartphone apps that 
are either user interfaces for cloud- 
based services or highly tethered to 
clouds for updates and data flows. 
While Wikipedia lists a few open- 
source IOS (http://en.wikipedia.org/ 
wiki/List_of_open_source_ 
iOS_applications) and Android 
(http://en.wikipedia.org/wiki/ 
List_of_open_source_Android_ 
applications) apps, those are just 
drops in an ocean of proprietary 
apps and services. 

In fact, even the packages of 
boxware you buy from Adobe and 
Microsoft are less owned than 
licensed. The collection of bits that 
come in a box, or are downloaded 
from a virtual store, are not tangible 
property. Instead, what you have 
is a bundle of rights for usage, 
governed by a seller to which the 
software remains attached by a 
service contract. So, the thinking 
then goes, why bother with 
old-fashioned ownership at all? 


Why not just rent? 

We already rent many other things 
in the digital world, such as domain 
names. Here at Linux Journal, we 
don’t own LinuxJournal.com. We 
rent it. The same goes for all the 
other domain names in the world. 
Every one is rented for finite periods 
of time. They can be bought or 
sold, but they can be possessed 
only so long as the owner keeps 
paying a domain registrar for the 
right to use them exclusively— 
meaning we rent them. 

Changing software into a 
subscription business is a slippery 
slope down which control of 
software moves from individual 
owners to corporate suppliers. 

Predictably and correctly, Richard 
M. Stallman began saying “the cloud” 
was “a trap” in 2008 (in this Guardian 
interview: http://www.guardian.co.uk/ 
technology/2008/sep/29/cloud. 
computing.richard.stallman). 
Here’s a sample: 


But there has been growing concern 
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So, the thinking then goes, why bother with 
old-fashioned ownership at all? Why not just rent? 


that mainstream adoption of cloud 
computing could present a mixture 
of privacy and ownership issues 
(http://www.guardian.co.uk/ 
technology/blog/2008/aug/06/ 
whengoogleownsyouyourdata), 
with users potentially being locked 
out of their own files. 


Stallman, who is a staunch privacy 
advocate, advised users to stay local 
and stick with their own computers. 


“One reason you should not 

use Web applications to do 

your computing is that you lose 
control”, he said. “It’s just as bad 
as using a proprietary program. 
Do your own computing on 

your own computer with your 
copy of a freedom-respecting 
program. If you use a proprietary 
program or somebody else’s Web 
server, you're defenseless. You're 
putty in the hands of whoever 
developed that software.” 


Free software and open-source 


software development, deployment 
and money-making. 

One name for the end-state of this 
shift is the “subscription economy”. 
Here at Linux Journal, we've been 
living in the subscription economy, 
as have all subscription periodicals. 
We also have done our best from the 
start to make our goods as free (as 
in freedom) as possible. We're not 
perfect at that, and we may never 
be, but free is where we come from. 
(In fact, Linux Journal originally was 
conceived, way back in 1993, as a 
free software magazine.) Meanwhile, 
most of the rest of the world lacks 
the same consciousness. Instead, the 
general consciousness has moved 
backward in time. In “When It Comes 
to Security, We're Back to Feudalism” 
(http://www.wired.com/ 
opinion/2012/11/feudal-security), 
Bruce Schneier says we “pledge 
allegiance to the united states of 
convenience” when we become 
“vassals” to the “feudal lord” called 
Google, Amazon, Facebook and 
Apple. He explains: 


principles and methods don’t fit 


well with cloud-based models of Feudalism provides security. 
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Classical medieval feudalism 
depended on overlapping, 
complex, hierarchical 
relationships. There were oaths 
and obligations: a series of rights 
and privileges. A critical aspect 
of this system was protection: 
vassals would pledge their 
allegiance to a lord, and in 
return, that lord would protect 
them from harm....And it’s this 
model that’s starting to permeate 
computer security today. 


Traditional computer security 
centered around users. Users 
had to purchase and install anti- 
virus software and firewalls, 
ensure their operating system 
and network were configured 
properly, update their software, 
and generally manage their own 
security. This model is breaking, 
largely due to two developments: 


1. New Internet-enabled devices 
where the vendor maintains more 
control over the hardware and 
software than we do—like the 
iPhone and Kindle; and 


2. Services where the host 
maintains our data for us—like 
Flickr and Hotmail. 


Now, we users must trust the 
security of these hardware 
manufacturers, software 
vendors and cloud providers. 
We choose to do it because of 
the convenience, redundancy, 
automation and shareability. 


He doesn't mention the phone 
and cable companies that 
intermediate our connections 
over the Internet, but their hearts 
are feudal to the core, and their 
enclosure plans are clear. While 
on the one hand they increase 
speeds and give us other benefits, 
they also have a highly vested 
interest in transforming the 
Internet from a free and open 
space to an enclosed one from 
which rents can be extracted to 
the max—just like they always were 
in telephony and cable television. 
At risk is the Net itself. 

Ten years ago, in my LJ article “Saving 
the Net” (http://www.linuxjournal.com/ 
article/6989), | began with this: 


Who Owns What? 

That's the fundamental 
question....Much is at stake, 
including Linux and its natural 


habitat: the Net. Both have 
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EOF 


If your ISP’s narc-ware detects what it thinks 
is copyright infringement happening over your 
Internet data flows, they can punish you. 


been extraordinarily good for 
business. Its perceived “threat” 
to Microsoft and the dot-com 
crash are both red herrings. Take 
away Linux and the Net, and both 
technology and the economy 
would be a whole lot worse. 


Both the Net and Linux were 
created, grew and flourished 
almost entirely outside the 
regulatory sphere. They are, ina 
literal sense, what free markets 
have done with their freedoms. 


Yet, there are some who do 

not care. Unfortunately, they're 
driving the conversation right 
now. Hollywood has lawmakers 
and news organizations convinced 
that file sharing is “piracy” 

and “theft”. Apple, Intel and 
Microsoft are quietly doing their 
deals with the Hollywood devil, 
crippling (or contemplating the 
crippling of) PC functionalities, to 
protect the intellectual property 
of “content producers”. 
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Where we are headed is toward 
Hollywood's model of the Net: one 
where we pay on a subscription 
basis for everything that matters, 
and where everybody—creators and 
consumers alike—need constantly 
to “clear rights” for usage, whether 
they know that’s what they're doing 
or not. Here’s more from my “Saving 
the Net” article: 


Two oddly allied mentalities 
provide intellectual air cover for 
these threats to the marketplace. 
One is the extreme comfort 
certain industries feel inside their 
regulatory environments. The 
other is the high regard political 
conservatives hold for successful 
enterprises. Combine the two, 
and you get conservatives eagerly 
rewarding companies whose 
primary achievements consist of 
successful long-term adaptation 
to highly regulated environments. 


Hollywood's latest subscriber-screwing 
success story is the Copyright Alert 


System (http://en.wikipedia.org/ 
wiki/Copyright_Alert_System), 
better known as “six strikes”. If your 
ISP’s narc-ware detects what it thinks 
is copyright infringement happening 
over your Internet data flows, they 
can punish you. The details of both 
detection and punishment matter less 
than the fact that they are spying 

on your private activities and can 
strangle your Net connection. And 
they can easily do that, because they 
have the upper hand. 

So, instead of two hands clapping, 
we have one hand slapping. 

Linux is in that hand, because 
Linux is in pretty much everything. 
Same with the Internet. Both 
have won, yet the promise of 
freedom, which drove Linux and 
the Net to success, is being traded 
for away for convenience. 

Eternal vigilance is the price 
of liberty, the saying goes 
(http://wiki.monticello.org/ 
mediawiki/index.php/ 
Eternal_vigilance_is_the_price_ 
of_liberty_(Quotation)). And, 
right now, the silence is killing us. 


Doc Searls is Senior Editor of Linux Journal. He is also a 
fellow with the Berkman Center for Internet and Society at 
Harvard University and the Center for Information Technology 
and Society at UC Santa Barbara. 


Aclvertiser Inclex 


Thank you as always for supporting our 


advertisers by buying their products! 


ADVERTISER URL 


1&1 p:/Awww.1and1.com 


AnDevCon Serine — http:/Avwww.AnDevCon.com 


Coup Wortp http://www.cloudwf.com/ 
Forum 


Emac, Inc. p:/Awww.emacinc.com 


EmperorLinux p:/Awww.emperorlinux.com 


IXsysTEMs, INC. p:/Awww.ixsystems.com 


KincStar USA p:/Awww.kingstarusa.com 


Mawnace ENGINE p:/Awww.manageengine.com 


O'Reitty Vetocity p:/velocityconf.com/sc 


OVH p:/Awww.ovh.com/us/index.xml 


Siticon MecHanics p:/Awww.siliconmechanics.com 


SouTHEast p://SouthEastLinuxFest.org 
Linux Fest 


Texas Linux Fest p://2013.texaslinuxfest.org/ 


USENIX FeperaTeD p:/Awww.usenix.org/conference/fcw13 95 
ConrereNces WEEK 


The Linux Journal brand's following has 
grown to a monthly readership nearly 
one million strong. Encompassing the 
magazine, Web site, newsletters and 
much more, Linux Journal offers the 
ideal content environment to help you 
reach your marketing objectives. For 

more information, please visit 
http://www.linuxjournal.com/advertising. 


WWW.LINUXJOURNAL.COM / MAY 2013 / 111 


COME BE A PART OF TXLF 2013: 
THE LARGEST LINUX AND OPEN SOURCE 
SOFTWARE CONFERENCE IN THE 
LONE START STATE! 


MAY 31-JUNE 1 Wp 


THE AT&T CONFERENCE CENTER 
IN AUSTIN, TEXAS 


MORE INFO AND REGISTRATION AT 
ee NTTP H/T EXASLINUXFEST.OR@ “css; 


pI Se EY 
SExAS NN 24 
I St 
b Fi C 
* 
| Fe 
se ON : 


